@sap-ux/adp-tooling 1.0.58 → 1.0.60

package/dist/base/abap/key-user-changes.d.ts

@@ -0,0 +1,29 @@
+import type { KeyUserChangeContent } from '@sap-ux/axios-extension';
+import type { ToolsLogger } from '@sap-ux/logger';
+/**
+ * Options for {@link fetchKeyUserChanges}.
+ */
+export interface FetchKeyUserChangesOptions {
+    system: string;
+    application: string;
+    client?: string;
+    username?: string;
+    password?: string;
+    logger: ToolsLogger;
+}
+/**
+ * Fetches the DEFAULT adaptation's key user changes from LREP for the given application.
+ *
+ * Mirrors the interactive `KeyUserImportPrompter` in `@sap-ux/generator-adp`:
+ * authenticate the ABAP provider, resolve the active flex version, list adaptations,
+ * locate the DEFAULT adaptation and download its key user changes.
+ *
+ * Errors propagate (strict-abort): callers should treat any rejection as a reason to
+ * abort the surrounding operation.
+ *
+ * @param options - System, application id, optional credentials, and a logger.
+ * @returns The key user changes attached to the DEFAULT adaptation. May be empty.
+ * @throws If the LREP API is unsupported, authentication fails, or no DEFAULT adaptation exists.
+ */
+export declare function fetchKeyUserChanges(options: FetchKeyUserChangesOptions): Promise<KeyUserChangeContent[]>;
+//# sourceMappingURL=key-user-changes.d.ts.map

package/dist/base/abap/key-user-changes.js

@@ -0,0 +1,56 @@
+import { getConfiguredProvider } from '../../abap/provider.js';
+const DEFAULT_ADAPTATION_ID = 'DEFAULT';
+/**
+ * Picks the active flex version. The LREP response lists the draft (`versionId === '0'`)
+ * first when one exists; in that case the second entry is the active version. Mirrors
+ * the behaviour of `@sap-ux/generator-adp`'s `determineFlexVersion`.
+ *
+ * @param flexVersions - Flex versions returned by LREP, in priority order.
+ * @returns The version id to use, or `undefined` when no usable version exists.
+ */
+function determineFlexVersion(flexVersions) {
+    if (!flexVersions?.length) {
+        return undefined;
+    }
+    if (flexVersions[0]?.versionId === '0') {
+        return flexVersions[1]?.versionId;
+    }
+    return flexVersions[0]?.versionId;
+}
+/**
+ * Fetches the DEFAULT adaptation's key user changes from LREP for the given application.
+ *
+ * Mirrors the interactive `KeyUserImportPrompter` in `@sap-ux/generator-adp`:
+ * authenticate the ABAP provider, resolve the active flex version, list adaptations,
+ * locate the DEFAULT adaptation and download its key user changes.
+ *
+ * Errors propagate (strict-abort): callers should treat any rejection as a reason to
+ * abort the surrounding operation.
+ *
+ * @param options - System, application id, optional credentials, and a logger.
+ * @returns The key user changes attached to the DEFAULT adaptation. May be empty.
+ * @throws If the LREP API is unsupported, authentication fails, or no DEFAULT adaptation exists.
+ */
+export async function fetchKeyUserChanges(options) {
+    const { system, application, client, username, password, logger } = options;
+    const provider = await getConfiguredProvider({ system, client, username, password }, logger);
+    // Ensures auth is performed up-front for Cloud Ready systems before subsequent calls.
+    await provider.isAbapCloud();
+    const lrep = provider.getLayeredRepository();
+    const flexVersionsResponse = await lrep.getFlexVersions(application);
+    const activeVersion = determineFlexVersion(flexVersionsResponse?.versions ?? []);
+    const adaptationsResponse = await lrep.listAdaptations(application, activeVersion);
+    const adaptations = adaptationsResponse?.adaptations ?? [];
+    if (!adaptations.length) {
+        throw new Error(`No adaptations found for application '${application}' on system '${system}'.`);
+    }
+    if (!adaptations.some((a) => a.id === DEFAULT_ADAPTATION_ID)) {
+        const available = adaptations.map((a) => a.id).join(', ');
+        throw new Error(`No DEFAULT adaptation found for application '${application}'. Available adaptations: ${available}.`);
+    }
+    const keyUserDataResponse = await lrep.getKeyUserData(application, DEFAULT_ADAPTATION_ID);
+    const contents = keyUserDataResponse?.contents ?? [];
+    logger.info(`Fetched ${contents.length} key user change(s) for DEFAULT adaptation of '${application}' on '${system}'.`);
+    return contents;
+}
+//# sourceMappingURL=key-user-changes.js.map

package/dist/base/helper.d.ts

@@ -129,4 +129,13 @@ export declare function filterAndMapInboundsToManifest(inbounds: Inbound[]): Man
  * @returns App ID (reference)
  */
 export declare function getBaseAppId(basePath: string): Promise<string>;
+/**
+ * Returns a non-colliding project directory name under `basePath`.
+ * Follows the `generator-adp` convention: `app.variant` → `app.variant2` → `app.variant3` …
+ *
+ * @param basePath Base directory to check for existing project folders.
+ * @param dirName Base name prefix; defaults to `"app.variant"`.
+ * @returns The first name in the sequence that does not yet exist on disk.
+ */
+export declare function getDefaultProjectName(basePath: string, dirName?: string): string;
 //# sourceMappingURL=helper.d.ts.map

package/dist/base/helper.js

@@ -257,4 +257,23 @@ export async function getBaseAppId(basePath) {
         throw new Error(`Failed to get app ID: ${error.message}`);
     }
 }
+/** Default prefix used when no `dirName` is passed to {@link getDefaultProjectName}. */
+const DEFAULT_PROJECT_PREFIX = 'app.variant';
+/**
+ * Returns a non-colliding project directory name under `basePath`.
+ * Follows the `generator-adp` convention: `app.variant` → `app.variant2` → `app.variant3` …
+ *
+ * @param basePath Base directory to check for existing project folders.
+ * @param dirName Base name prefix; defaults to `"app.variant"`.
+ * @returns The first name in the sequence that does not yet exist on disk.
+ */
+export function getDefaultProjectName(basePath, dirName = DEFAULT_PROJECT_PREFIX) {
+    let newDir = dirName;
+    let index = 1;
+    while (existsSync(join(basePath, newDir))) {
+        index++;
+        newDir = `${dirName}${index}`;
+    }
+    return newDir;
+}
 //# sourceMappingURL=helper.js.map

package/dist/index.d.ts

@@ -12,6 +12,7 @@ export * from './base/credentials.js';
 export * from './base/constants/index.js';
 export * from './base/project-builder.js';
 export * from './base/abap/manifest-service.js';
+export * from './base/abap/key-user-changes.js';
 export { writeKeyUserChanges } from './base/change-utils.js';
 export { promptGeneratorInput, type PromptDefaults } from './base/prompt.js';
 export * from './preview/adp-preview.js';

package/dist/index.js

@@ -12,6 +12,7 @@ export * from './base/credentials.js';
 export * from './base/constants/index.js';
 export * from './base/project-builder.js';
 export * from './base/abap/manifest-service.js';
+export * from './base/abap/key-user-changes.js';
 export { writeKeyUserChanges } from './base/change-utils.js';
 export { promptGeneratorInput } from './base/prompt.js';
 export * from './preview/adp-preview.js';

package/package.json

@@ -10,7 +10,7 @@
   "bugs": {
     "url": "https://github.com/SAP/open-ux-tools/issues?q=is%3Aopen+is%3Aissue+label%3Abug+label%3Aadp-tooling"
   },
-  "version": "1.0.58",
+  "version": "1.0.60",
   "license": "Apache-2.0",
   "author": "@SAP/ux-tools-team",
   "main": "dist/index.js",
@@ -46,7 +46,7 @@
     "@sap-ux/nodejs-utils": "1.0.10",
     "@sap-ux/odata-service-writer": "1.0.23",
     "@sap-ux/project-access": "2.2.1",
-    "@sap-ux/project-input-validator": "1.0.20",
+    "@sap-ux/project-input-validator": "1.0.21",
     "@sap-ux/store": "2.0.7",
     "@sap-ux/system-access": "1.0.14",
     "@sap-ux/ui5-config": "1.0.9",