@rayutek/abap-adt-api 6.2.1-pkg-1.0.0

package/build/AdtException.js

@@ -0,0 +1,185 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isErrorMessageType = exports.validateParseResult = exports.ValidateStateful = exports.ValidateObjectUrl = exports.adtException = exports.fromException = exports.fromError = exports.fromResponse = exports.isLoginError = exports.isAdtException = exports.isHttpError = exports.isCsrfError = exports.isAdtError = exports.AdtErrorException = exports.SAPRC = void 0;
+const utilities_1 = require("./utilities");
+const axios_1 = __importDefault(require("axios"));
+const These_1 = require("fp-ts/lib/These");
+const io_ts_reporters_1 = __importDefault(require("io-ts-reporters"));
+const ADTEXTYPEID = Symbol.for("ADT EXCEPTION");
+const CSRFEXTYPEID = Symbol.for("BAD CSRF");
+const HTTPEXTYPEID = Symbol.for("HTTP EXCEPTION");
+var SAPRC;
+(function (SAPRC) {
+    SAPRC["Success"] = "S";
+    SAPRC["Info"] = "I";
+    SAPRC["Warning"] = "W";
+    SAPRC["Error"] = "E";
+    SAPRC["CriticalError"] = "A";
+    SAPRC["Exception"] = "X";
+})(SAPRC = exports.SAPRC || (exports.SAPRC = {}));
+const isResponse = (r) => (0, utilities_1.isObject)(r) && !!(r === null || r === void 0 ? void 0 : r.status) && (0, utilities_1.isString)(r === null || r === void 0 ? void 0 : r.statusText);
+class AdtErrorException extends Error {
+    get typeID() {
+        return ADTEXTYPEID;
+    }
+    static create(errOrResponse, properties, type, message, parent, namespace, localizedMessage, response) {
+        if (!(0, utilities_1.isNumber)(errOrResponse)) {
+            return this.create(errOrResponse.status, properties, "", errOrResponse.statusText || "Unknown error in adt client", undefined, undefined, undefined, errOrResponse);
+        }
+        else {
+            return new AdtErrorException(errOrResponse, properties, type, message, parent, namespace, localizedMessage, response);
+        }
+    }
+    constructor(err, properties, type, message, parent, namespace, localizedMessage, response) {
+        super();
+        this.err = err;
+        this.properties = properties;
+        this.type = type;
+        this.message = message;
+        this.parent = parent;
+        this.namespace = namespace;
+        this.localizedMessage = localizedMessage;
+        this.response = response;
+    }
+}
+exports.AdtErrorException = AdtErrorException;
+// tslint:disable-next-line:max-classes-per-file
+class AdtCsrfException extends Error {
+    get typeID() {
+        return CSRFEXTYPEID;
+    }
+    constructor(message, parent) {
+        super();
+        this.message = message;
+        this.parent = parent;
+    }
+}
+// tslint:disable-next-line:max-classes-per-file
+class AdtHttpException extends Error {
+    get typeID() {
+        return HTTPEXTYPEID;
+    }
+    get code() {
+        const p = this.parent;
+        return (p.response && p.response.status) || 0;
+    }
+    get message() {
+        return this.parent.message;
+    }
+    get name() {
+        return this.parent.name;
+    }
+    constructor(parent) {
+        super();
+        this.parent = parent;
+    }
+}
+function isAdtError(e) {
+    return (e === null || e === void 0 ? void 0 : e.typeID) === ADTEXTYPEID;
+}
+exports.isAdtError = isAdtError;
+function isCsrfError(e) {
+    return (e === null || e === void 0 ? void 0 : e.typeID) === CSRFEXTYPEID;
+}
+exports.isCsrfError = isCsrfError;
+function isHttpError(e) {
+    return (e === null || e === void 0 ? void 0 : e.typeID) === HTTPEXTYPEID;
+}
+exports.isHttpError = isHttpError;
+function isAdtException(e) {
+    return isAdtError(e) || isCsrfError(e) || isHttpError(e);
+}
+exports.isAdtException = isAdtException;
+const isLoginError = (adtErr) => (isHttpError(adtErr) && adtErr.code === 401) || isCsrfError(adtErr);
+exports.isLoginError = isLoginError;
+const simpleError = (response) => adtException(`Error ${response.status}:${response.statusText}`, response.status);
+const isCsrfException = (r) => (r.status === 403 && r.headers["x-csrf-token"] === "Required") ||
+    (r.status === 400 && r.statusText === "Session timed out"); // hack to get login refresh to work on expired sessions
+const fromResponse = (data, response) => {
+    if (!data)
+        return simpleError(response);
+    if (data.match(/CSRF/))
+        return new AdtCsrfException(data);
+    const raw = (0, utilities_1.fullParse)(data);
+    const root = raw["exc:exception"];
+    if (!root && response.status === 401)
+        return simpleError(response);
+    const getf = (base, idx) => (base ? base[idx] : "");
+    const properties = {};
+    (0, utilities_1.xmlArray)(root, "properties", "entry").forEach((p) => {
+        properties[p["@_key"]] = `${p["#text"]}`
+            .replace(/^\s+/, "")
+            .replace(/\s+$/, "");
+    });
+    return new AdtErrorException(response.status, properties, root.type["@_id"], root.message["#text"], undefined, getf(root.namespace, "@_id"), getf(root.localizedMessage, "#text"));
+};
+exports.fromResponse = fromResponse;
+const axiosErrorBody = (e) => { var _a; return ((_a = e.response) === null || _a === void 0 ? void 0 : _a.data) ? `${e.response.data}` : ""; };
+const fromError = (error) => {
+    try {
+        if (isAdtError(error))
+            return error;
+        if (axios_1.default.isAxiosError(error) && error.response) {
+            if (error.status === 401)
+                return new AdtHttpException(error);
+            return (0, exports.fromResponse)(axiosErrorBody(error), error.response);
+        }
+        if ((0, utilities_1.isObject)(error) && "message" in error && (0, utilities_1.isString)(error === null || error === void 0 ? void 0 : error.message))
+            return new AdtErrorException(500, {}, "", error.message);
+    }
+    catch (error) { }
+    return AdtErrorException.create(500, {}, "Unknown error", `${error}`); // hopefully will never happen
+};
+exports.fromError = fromError;
+function fromExceptionOrResponse_int(errOrResp, config) {
+    try {
+        if (isResponse(errOrResp))
+            return (0, exports.fromResponse)(errOrResp.body, errOrResp);
+        else
+            return (0, exports.fromError)(errOrResp);
+    }
+    catch (e) {
+        return isResponse(errOrResp)
+            ? AdtErrorException.create(errOrResp, {})
+            : (0, exports.fromError)(e);
+    }
+}
+function fromException(errOrResp, config) {
+    if (isAdtException(errOrResp))
+        return errOrResp;
+    if (!isResponse(errOrResp) &&
+        (!(0, utilities_1.isNativeError)(errOrResp) ||
+            ((0, utilities_1.isNativeError)(errOrResp) && !axios_1.default.isAxiosError(errOrResp))))
+        return AdtErrorException.create(500, {}, "Unknown error", `${errOrResp}`); // hopefully will never happen
+    return fromExceptionOrResponse_int(errOrResp, config);
+}
+exports.fromException = fromException;
+function adtException(message, number = 0) {
+    return new AdtErrorException(number, {}, "", message);
+}
+exports.adtException = adtException;
+function ValidateObjectUrl(url) {
+    if (url.match(/^\/sap\/bc\/adt\/[a-z]+\/[a-zA-Z%\$]?[\w%]+/))
+        return; // valid
+    throw new AdtErrorException(0, {}, "BADOBJECTURL", "Invalid Object URL:" + url);
+}
+exports.ValidateObjectUrl = ValidateObjectUrl;
+function ValidateStateful(h) {
+    if (h.isStateful)
+        return;
+    throw new AdtErrorException(0, {}, "STATELESS", "This operation can only be performed in stateful mode");
+}
+exports.ValidateStateful = ValidateStateful;
+const validateParseResult = (parseResult) => {
+    if ((0, These_1.isLeft)(parseResult)) {
+        const messages = io_ts_reporters_1.default.report(parseResult);
+        throw adtException(messages.slice(0, 3).join("\n"));
+    }
+    return parseResult.right;
+};
+exports.validateParseResult = validateParseResult;
+const isErrorMessageType = (x) => !!`${x}`.match(/^[EAX]$/i);
+exports.isErrorMessageType = isErrorMessageType;

package/build/AdtHTTP.d.ts

@@ -0,0 +1,113 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { AxiosBasicCredentials, Method, AxiosResponseHeaders } from "axios";
+import https from "https";
+import { LogCallback } from ".";
+export declare enum session_types {
+    stateful = "stateful",
+    stateless = "stateless",
+    keep = ""
+}
+export interface HttpResponse {
+    body: string;
+}
+export interface ClientOptions {
+    headers?: Record<string, string>;
+    httpsAgent?: https.Agent;
+    baseURL?: string;
+    debugCallback?: LogCallback;
+    timeout?: number;
+    auth?: AxiosBasicCredentials;
+    keepAlive?: boolean;
+}
+export interface RequestOptions extends ClientOptions {
+    method?: Method;
+    headers?: Record<string, string>;
+    httpsAgent?: https.Agent;
+    qs?: Record<string, any>;
+    baseURL?: string;
+    timeout?: number;
+    auth?: AxiosBasicCredentials;
+    body?: string;
+    url?: string;
+}
+export type BearerFetcher = () => Promise<string>;
+export interface HttpClientResponse {
+    body: string;
+    status: number;
+    statusText: string;
+    headers: AxiosResponseHeaders;
+    request?: any;
+}
+interface RequestMetadata {
+    adtRequestNumber?: number;
+    adtStartTime?: Date;
+}
+export interface HttpClientOptions extends RequestOptions, RequestMetadata {
+    url: string;
+}
+/**
+ * Abstract HTTP client
+ * cookies, authentication and CSRF tokens usually handled by higher level intercacve
+ */
+export interface HttpClient {
+    /**
+     * HTTP request
+     * @param options url, headers,...
+     * @returns the result of the HTTP call
+     *
+     * expected to throw only AdtException errors
+     */
+    request: (options: HttpClientOptions) => Promise<HttpClientResponse>;
+}
+export declare class AxiosHttpClient implements HttpClient {
+    private baseURL;
+    private axios;
+    constructor(baseURL: string, config?: ClientOptions);
+    request(options: HttpClientOptions): Promise<HttpClientResponse>;
+}
+export declare class AdtHTTP {
+    readonly username: string;
+    readonly client: string;
+    readonly language: string;
+    readonly baseURL: string;
+    readonly id: number;
+    readonly password?: string;
+    isClone: boolean;
+    private currentSession;
+    private _stateful;
+    private needKeepalive;
+    readonly keepAlive?: NodeJS.Timer;
+    private commonHeaders;
+    private bearer?;
+    private getToken?;
+    private auth?;
+    private httpclient;
+    private debugCallback?;
+    private loginPromise?;
+    get isStateful(): boolean;
+    get stateful(): session_types;
+    set stateful(value: session_types);
+    get csrfToken(): string;
+    set csrfToken(token: string);
+    get loggedin(): boolean;
+    constructor(baseURLOrClient: string | HttpClient, username: string, password: string | BearerFetcher, client: string, language: string, config?: ClientOptions);
+    login(): Promise<any>;
+    private cookie;
+    ascookies(): string;
+    logout(): Promise<void>;
+    dropSession(): Promise<void>;
+    request(url: string, config?: RequestOptions): Promise<HttpClientResponse>;
+    private keep_session;
+    private updateCookies;
+    private logResponse;
+    /**
+     * HTTP request without automated login / retry
+     *
+     * @param url URL suffix
+     * @param options request options
+     */
+    private _request;
+}
+export {};
+//# sourceMappingURL=AdtHTTP.d.ts.map

package/build/AdtHTTP.d.ts.map

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

package/build/AdtHTTP.js

@@ -0,0 +1,285 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdtHTTP = exports.AxiosHttpClient = exports.session_types = void 0;
+const axios_1 = __importStar(require("axios"));
+const AdtException_1 = require("./AdtException");
+const _1 = require(".");
+const requestLogger_1 = require("./requestLogger");
+const utilities_1 = require("./utilities");
+const FETCH_CSRF_TOKEN = "fetch";
+const CSRF_TOKEN_HEADER = "x-csrf-token";
+const SESSION_HEADER = "X-sap-adt-sessiontype";
+const runningInNode = typeof process !== "undefined" &&
+    process.versions != null &&
+    process.versions.node != null;
+let lastClientId = 0;
+var session_types;
+(function (session_types) {
+    session_types["stateful"] = "stateful";
+    session_types["stateless"] = "stateless";
+    session_types["keep"] = "";
+})(session_types = exports.session_types || (exports.session_types = {}));
+const toAxiosConfig = (options) => {
+    const config = {
+        method: options.method || "GET",
+        url: options.url,
+        headers: options.headers || {},
+        params: options.qs,
+        httpsAgent: options.httpsAgent,
+        timeout: options.timeout,
+        auth: options.auth,
+        data: options.body,
+        adtRequestNumber: options.adtRequestNumber,
+        adtStartTime: options.adtStartTime
+    };
+    return config;
+};
+let adtRequestNumber = 0;
+const convertheaders = (raw) => {
+    if (raw instanceof axios_1.AxiosHeaders)
+        return raw;
+    const headers = new axios_1.AxiosHeaders();
+    for (const k in Object.keys(raw))
+        headers.set(k, raw[k]);
+    return headers;
+};
+class AxiosHttpClient {
+    constructor(baseURL, config) {
+        this.baseURL = baseURL;
+        const conf = toAxiosConfig({ ...config });
+        this.axios = axios_1.default.create({ ...conf, baseURL });
+    }
+    async request(options) {
+        try {
+            const config = toAxiosConfig(options);
+            const { data, headers, ...rest } = await this.axios.request(config);
+            const body = data ? ((0, utilities_1.isString)(data) ? data : `${data}`) : "";
+            return { body, headers: convertheaders(headers), ...rest };
+        }
+        catch (error) {
+            throw (0, _1.fromError)(error);
+        }
+    }
+}
+exports.AxiosHttpClient = AxiosHttpClient;
+class AdtHTTP {
+    get isStateful() {
+        return (this.stateful === session_types.stateful ||
+            (this.stateful === session_types.keep &&
+                this.currentSession === session_types.stateful));
+    }
+    get stateful() {
+        return this._stateful;
+    }
+    set stateful(value) {
+        this._stateful = value;
+        if (value !== session_types.keep)
+            this.currentSession = value;
+    }
+    get csrfToken() {
+        return this.commonHeaders[CSRF_TOKEN_HEADER] || FETCH_CSRF_TOKEN;
+    }
+    set csrfToken(token) {
+        this.commonHeaders[CSRF_TOKEN_HEADER] = token;
+    }
+    get loggedin() {
+        return this.csrfToken !== FETCH_CSRF_TOKEN;
+    }
+    constructor(baseURLOrClient, username, password, client, language, config) {
+        this.username = username;
+        this.client = client;
+        this.language = language;
+        this.isClone = false;
+        this.currentSession = session_types.stateless;
+        this._stateful = session_types.stateless;
+        this.needKeepalive = false;
+        this.cookie = new Map();
+        this.keep_session = async () => {
+            if (this.needKeepalive && this.loggedin)
+                await this._request("/sap/bc/adt/compatibility/graph", {}).catch(() => { });
+            this.needKeepalive = true;
+        };
+        if (!(baseURLOrClient && username && (password || !(0, utilities_1.isString)(baseURLOrClient))))
+            throw (0, _1.adtException)("Invalid ADTClient configuration: url, login and password are required");
+        this.baseURL = (0, utilities_1.isString)(baseURLOrClient) ? baseURLOrClient : "";
+        this.id = lastClientId++;
+        if ((0, utilities_1.isString)(password))
+            this.password = password;
+        else
+            this.getToken = password;
+        this.commonHeaders = {
+            ...config === null || config === void 0 ? void 0 : config.headers,
+            Accept: "*/*",
+            "Cache-Control": "no-cache",
+            [CSRF_TOKEN_HEADER]: FETCH_CSRF_TOKEN
+        };
+        this.httpclient = (0, utilities_1.isString)(baseURLOrClient)
+            ? new AxiosHttpClient(baseURLOrClient, config)
+            : baseURLOrClient;
+        this.debugCallback = config === null || config === void 0 ? void 0 : config.debugCallback;
+        if (config === null || config === void 0 ? void 0 : config.keepAlive)
+            this.keepAlive = setInterval(() => this.keep_session(), 120000);
+    }
+    async login() {
+        if (this.loginPromise)
+            return this.loginPromise;
+        this.cookie.clear();
+        // oauth
+        if (this.getToken && !this.bearer) {
+            await this.getToken().then(bearer => (this.bearer = bearer));
+        }
+        else
+            this.auth = {
+                username: this.username || "",
+                password: this.password || ""
+            };
+        const qs = {};
+        if (this.client)
+            qs["sap-client"] = this.client;
+        if (this.language)
+            qs["sap-language"] = this.language;
+        this.csrfToken = FETCH_CSRF_TOKEN;
+        try {
+            this.loginPromise = this._request("/sap/bc/adt/compatibility/graph", {
+                qs
+            });
+            await this.loginPromise;
+        }
+        finally {
+            this.loginPromise = undefined;
+        }
+    }
+    ascookies() {
+        return [...this.cookie.values()].join("; ");
+    }
+    async logout() {
+        this.stateful = session_types.stateless;
+        await this._request("/sap/public/bc/icf/logoff", {});
+        // prevent autologin
+        this.auth = undefined;
+        this.bearer = undefined;
+        // new cookie jar
+        this.cookie.clear();
+        // clear token
+        this.csrfToken = FETCH_CSRF_TOKEN;
+    }
+    async dropSession() {
+        this.stateful = session_types.stateless;
+        await this._request("/sap/bc/adt/compatibility/graph", {});
+    }
+    async request(url, config) {
+        let autologin = false;
+        try {
+            if (!this.loggedin) {
+                autologin = true;
+                await this.login();
+            }
+            return await this._request(url, config || {});
+        }
+        catch (e) {
+            const adtErr = (0, AdtException_1.fromException)(e, config);
+            // if the logon ticket expired try to logon again, unless in stateful mode
+            // or already tried a login
+            if ((0, _1.isLoginError)(adtErr) && !autologin && !this.isStateful) {
+                try {
+                    this.csrfToken = FETCH_CSRF_TOKEN;
+                    await this.login();
+                    return await this._request(url, config || {});
+                }
+                catch (e2) {
+                    throw (0, AdtException_1.fromException)(e2, config);
+                }
+            }
+            else
+                throw adtErr;
+        }
+    }
+    updateCookies(response) {
+        if (runningInNode) {
+            const cookies = response.headers["set-cookie"] || [];
+            cookies.forEach(cookie => {
+                const cleaned = cookie
+                    .replace(/path=\/,/g, "")
+                    .replace(/path=\//g, "")
+                    .split(";")[0];
+                const [key] = cookie.split("=", 1);
+                this.cookie.set(key, cleaned);
+            });
+        }
+    }
+    logResponse(exceptionOrResponse, options) {
+        if (!this.debugCallback)
+            return;
+        if ((0, _1.isAdtException)(exceptionOrResponse))
+            (0, requestLogger_1.logError)(this.id, exceptionOrResponse, this.debugCallback, options);
+        else
+            (0, requestLogger_1.logResponse)(this.id, exceptionOrResponse, options, this.debugCallback);
+    }
+    /**
+     * HTTP request without automated login / retry
+     *
+     * @param url URL suffix
+     * @param options request options
+     */
+    async _request(url, options) {
+        this.needKeepalive = false;
+        const headers = { ...this.commonHeaders, ...options.headers };
+        headers[SESSION_HEADER] = this.stateful;
+        if (!headers["Cookie"] && runningInNode)
+            headers["Cookie"] = this.ascookies();
+        adtRequestNumber++;
+        const adtStartTime = new Date();
+        const config = {
+            ...options,
+            auth: this.auth,
+            headers,
+            adtStartTime,
+            adtRequestNumber,
+            url
+        };
+        try {
+            if (this.getToken && !this.bearer)
+                this.bearer = await this.getToken();
+            if (this.bearer)
+                headers.Authorization = `bearer ${this.bearer}`;
+            const response = await this.httpclient.request(config);
+            this.updateCookies(response);
+            if (response.status >= 400)
+                throw (0, AdtException_1.fromException)(response, config);
+            if (this.csrfToken === FETCH_CSRF_TOKEN &&
+                (0, utilities_1.isString)(response.headers[CSRF_TOKEN_HEADER]))
+                this.csrfToken = response.headers[CSRF_TOKEN_HEADER];
+            this.logResponse(response, config);
+            return response;
+        }
+        catch (error) {
+            const exc = (0, AdtException_1.fromException)(error, config);
+            this.logResponse(exc, config);
+            throw exc;
+        }
+    }
+}
+exports.AdtHTTP = AdtHTTP;

package/build/api/abapgit.d.ts

@@ -0,0 +1,86 @@
+import { AdtHTTP } from "../AdtHTTP";
+export interface GitLink {
+    href: string;
+    rel: string;
+    type?: "pull_link" | "stage_link" | "push_link" | "check_link" | "status_link" | "log_link" | string;
+}
+export interface GitRepo {
+    key: string;
+    sapPackage: string;
+    url: string;
+    branch_name: string;
+    created_by: string;
+    created_at: Date;
+    created_email?: string;
+    deserialized_by?: string;
+    deserialized_email?: string;
+    deserialized_at?: Date;
+    status?: string;
+    status_text?: string;
+    links: GitLink[];
+}
+export interface GitBranch {
+    sha1: string;
+    name: string;
+    type: string;
+    is_head: boolean;
+    display_name: string;
+}
+export interface GitExternalInfo {
+    access_mode: "PUBLIC" | "PRIVATE";
+    branches: GitBranch[];
+}
+export interface GitObject {
+    obj_type: string;
+    obj_name: string;
+    package: string;
+    obj_status: string;
+    msg_type: string;
+    msg_text: string;
+}
+export interface GitStagingFile {
+    name: string;
+    path: string;
+    localState: string;
+    links: GitLink[];
+}
+export interface GitStagingObject {
+    wbkey: string;
+    uri: string;
+    type: string;
+    name: string;
+    abapGitFiles: GitStagingFile[];
+}
+export interface GitUser {
+    name: string;
+    email: string;
+}
+export interface GitStaging {
+    staged: GitStagingObject[];
+    unstaged: GitStagingObject[];
+    ignored: GitStagingObject[];
+    comment: string;
+    author: GitUser;
+    committer: GitUser;
+}
+/**
+ * @deprecated since 1.2.1, duplicate of GitExternalInfo
+ */
+export interface GitRemoteInfo {
+    access_mode: string;
+    branches: GitBranch[];
+}
+export declare function gitRepos(h: AdtHTTP): Promise<GitRepo[]>;
+export declare function externalRepoInfo(h: AdtHTTP, repourl: string, user?: string, password?: string): Promise<GitExternalInfo>;
+export declare function createRepo(h: AdtHTTP, packageName: string, repourl: string, branch?: string, transport?: string, user?: string, password?: string): Promise<void[]>;
+export declare function pullRepo(h: AdtHTTP, repoId: string, branch?: string, transport?: string, user?: string, password?: string): Promise<void[]>;
+export declare function unlinkRepo(h: AdtHTTP, repoId: string): Promise<void>;
+export declare function checkRepo(h: AdtHTTP, repo: GitRepo, user?: string, password?: string): Promise<void>;
+export declare function pushRepo(h: AdtHTTP, repo: GitRepo, staging: GitStaging, user?: string, password?: string): Promise<void>;
+export declare function stageRepo(h: AdtHTTP, repo: GitRepo, user?: string, password?: string): Promise<GitStaging>;
+/**
+ * @deprecated since 1.2.1, duplicate of externalRepoInfo
+ */
+export declare function remoteRepoInfo(h: AdtHTTP, repo: GitRepo, user?: string, password?: string): Promise<GitRemoteInfo>;
+export declare function switchRepoBranch(h: AdtHTTP, repo: GitRepo, branch: string, create?: boolean, user?: string, password?: string): Promise<void>;
+//# sourceMappingURL=abapgit.d.ts.map

package/build/api/abapgit.d.ts.map

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