@mcp-abap-adt/interfaces 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -7,6 +7,47 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.7] - 2025-12-10
+
+### Added
+- **Transport Request Builder Configuration Interface**: Added `ITransportBuilderConfig` interface
+  - Configuration interface for Transport Request operations
+  - Fields: `description`, `transportType`, `targetSystem`, `owner`, `transportNumber`
+  - Located in `src/adt/ITransportBuilderConfig.ts`
+  - Exported from package root: `import { ITransportBuilderConfig } from '@mcp-abap-adt/interfaces'`
+- **Unit Test Builder Configuration Interfaces**: Added unit test configuration interfaces
+  - `IUnitTestBuilderConfig` - Main configuration interface for unit test operations
+    - Fields: `tests`, `options`, `runId`, `status`, `result`
+  - `IClassUnitTestDefinition` - Interface for defining class unit tests
+    - Fields: `containerClass`, `testClass`
+  - `IClassUnitTestRunOptions` - Interface for unit test run options
+    - Fields: `title`, `context`, `scope`, `riskLevel`, `duration`
+  - Located in `src/adt/IUnitTestBuilderConfig.ts`
+  - Exported from package root: `import { IUnitTestBuilderConfig, IClassUnitTestDefinition, IClassUnitTestRunOptions } from '@mcp-abap-adt/interfaces'`
+
+## [0.1.6] - 2025-12-09
+
+### Added
+- **Unified Operation Options Interface**: Created `IAdtOperationOptions` interface
+  - Unified interface for both create and update operations (replaces `CreateOptions` and `UpdateOptions`)
+  - Includes all fields from both interfaces: `activateOnCreate`, `activateOnUpdate`, `deleteOnFailure`, `sourceCode`, `xmlContent`, `timeout`
+  - `sourceCode` and `xmlContent` now available for update operations (previously only in create)
+  - `timeout?: number` - Timeout for operations in milliseconds (default: 1000)
+    - Prevents operation failures due to system not completing commands in time
+    - Increase timeout for complex operations or slow systems
+
+### Changed
+- **Operation Options Interfaces**: Unified `CreateOptions` and `UpdateOptions` into `IAdtOperationOptions`
+  - Both create and update operations now use the same interface
+  - `sourceCode` and `xmlContent` are now available for update operations
+  - Removed `lockHandle` field from update options (update operations always start with lock internally)
+  - All interfaces now follow `I` prefix convention (`IAdtOperationOptions`)
+
+### Removed
+- **Deprecated Interfaces**: Removed `CreateOptions` and `UpdateOptions` interfaces
+  - Replaced by unified `IAdtOperationOptions` interface
+  - No backward compatibility maintained (version < 1.0.0)
+
 ## [0.1.5] - 2025-12-09
 
 ### Added

package/dist/adt/IAdtObject.d.ts

@@ -9,46 +9,46 @@
  */
 import { AxiosResponse } from 'axios';
 /**
- * Options for create operations
+ * Options for ADT operations (create and update)
+ * Unified interface for both create and update operations
  */
-export interface CreateOptions {
+export interface IAdtOperationOptions {
     /**
-     * Activate object after creation
+     * Activate object after creation (for create operations)
      * @default false
      */
     activateOnCreate?: boolean;
     /**
-     * Delete object if creation fails
+     * Activate object after update (for update operations)
+     * @default false
+     */
+    activateOnUpdate?: boolean;
+    /**
+     * Delete object if operation fails
      * @default false
      */
     deleteOnFailure?: boolean;
     /**
-     * Source code to use for update after create
+     * Source code to use for update
+     * Used in create operations for update after create, and in update operations
      */
     sourceCode?: string;
     /**
-     * XML content to use for update after create
+     * XML content to use for update
+     * Used for objects that use XML format (e.g., Domain, DataElement)
+     * Used in create operations for update after create, and in update operations
      */
     xmlContent?: string;
-}
-/**
- * Options for update operations
- */
-export interface UpdateOptions {
     /**
-     * Activate object after update
-     * @default false
-     */
-    activateOnUpdate?: boolean;
-    /**
-     * Delete object if update fails
-     * @default false
-     */
-    deleteOnFailure?: boolean;
-    /**
-     * Lock handle if object is already locked
+     * Timeout for operations in milliseconds
+     * @default 1000 (1 second)
+     *
+     * CRITICAL: Without timeouts, operations may fail due to system not completing commands in time.
+     * Increase timeout for complex operations or slow systems.
+     *
+     * Example: timeout: 5000 for 5 seconds
      */
-    lockHandle?: string;
+    timeout?: number;
 }
 /**
  * High-level ADT Object Operations Interface
@@ -76,7 +76,7 @@ export interface IAdtObject<TConfig, TReadResult = TConfig> {
      * @throws Error if validation fails (object is not created)
      * @throws Error if any operation fails (with cleanup if deleteOnFailure=true)
      */
-    create(config: TConfig, options?: CreateOptions): Promise<TReadResult>;
+    create(config: TConfig, options?: IAdtOperationOptions): Promise<TReadResult>;
     /**
      * Read object
      * @param config - Object identification (name, etc.)
@@ -94,7 +94,7 @@ export interface IAdtObject<TConfig, TReadResult = TConfig> {
      * @throws Error if lock fails
      * @throws Error if any operation fails (with cleanup if deleteOnFailure=true)
      */
-    update(config: Partial<TConfig>, options?: UpdateOptions): Promise<TReadResult>;
+    update(config: Partial<TConfig>, options?: IAdtOperationOptions): Promise<TReadResult>;
     /**
      * Delete object
      * Performs deletion check before deleting.

package/dist/adt/IAdtObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IAdtObject.d.ts","sourceRoot":"","sources":["../../src/adt/IAdtObject.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO;IACxD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE3D;;;;;;;;;OASG;IACH,MAAM,CACJ,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB;;;;;OAKG;IACH,IAAI,CACF,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,EACxB,OAAO,CAAC,EAAE,QAAQ,GAAG,UAAU,GAC9B,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAEpC;;;;;;;;;OASG;IACH,MAAM,CACJ,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,EACxB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEzD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE3D;;;;;OAKG;IACH,KAAK,CACH,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,EACxB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3B"}
+{"version":3,"file":"IAdtObject.d.ts","sourceRoot":"","sources":["../../src/adt/IAdtObject.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO;IACxD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE3D;;;;;;;;;OASG;IACH,MAAM,CACJ,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB;;;;;OAKG;IACH,IAAI,CACF,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,EACxB,OAAO,CAAC,EAAE,QAAQ,GAAG,UAAU,GAC9B,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAEpC;;;;;;;;;OASG;IACH,MAAM,CACJ,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,EACxB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEzD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE3D;;;;;OAKG;IACH,KAAK,CACH,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,EACxB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3B"}

package/dist/adt/ITransportBuilderConfig.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Transport Request Builder Configuration Interface
+ */
+export interface ITransportBuilderConfig {
+    description: string;
+    transportType?: 'workbench' | 'customizing';
+    targetSystem?: string;
+    owner?: string;
+    transportNumber?: string;
+}
+//# sourceMappingURL=ITransportBuilderConfig.d.ts.map

package/dist/adt/ITransportBuilderConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITransportBuilderConfig.d.ts","sourceRoot":"","sources":["../../src/adt/ITransportBuilderConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/adt/ITransportBuilderConfig.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Transport Request Builder Configuration Interface
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/adt/IUnitTestBuilderConfig.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Unit Test Builder Configuration Interface
+ */
+export interface IClassUnitTestDefinition {
+    containerClass: string;
+    testClass: string;
+}
+export interface IClassUnitTestRunOptions {
+    title?: string;
+    context?: string;
+    scope?: {
+        ownTests?: boolean;
+        foreignTests?: boolean;
+        addForeignTestsAsPreview?: boolean;
+    };
+    riskLevel?: {
+        harmless?: boolean;
+        dangerous?: boolean;
+        critical?: boolean;
+    };
+    duration?: {
+        short?: boolean;
+        medium?: boolean;
+        long?: boolean;
+    };
+}
+export interface IUnitTestBuilderConfig {
+    tests: IClassUnitTestDefinition[];
+    options?: IClassUnitTestRunOptions;
+    runId?: string;
+    status?: any;
+    result?: any;
+}
+//# sourceMappingURL=IUnitTestBuilderConfig.d.ts.map

package/dist/adt/IUnitTestBuilderConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IUnitTestBuilderConfig.d.ts","sourceRoot":"","sources":["../../src/adt/IUnitTestBuilderConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,wBAAwB,CAAC,EAAE,OAAO,CAAC;KACpC,CAAC;IACF,SAAS,CAAC,EAAE;QACV,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,wBAAwB,EAAE,CAAC;IAClC,OAAO,CAAC,EAAE,wBAAwB,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,MAAM,CAAC,EAAE,GAAG,CAAC;CACd"}

package/dist/adt/IUnitTestBuilderConfig.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Unit Test Builder Configuration Interface
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/index.d.ts

@@ -26,5 +26,7 @@ export { AuthMethodPriority } from './validation/IValidatedAuthConfig';
 export type { ITokenRefreshResult } from './utils/ITokenRefreshResult';
 export type { ITimeoutConfig } from './utils/ITimeoutConfig';
 export * from './Headers';
-export type { IAdtObject, CreateOptions, UpdateOptions } from './adt/IAdtObject';
+export type { IAdtObject, IAdtOperationOptions } from './adt/IAdtObject';
+export type { ITransportBuilderConfig } from './adt/ITransportBuilderConfig';
+export type { IUnitTestBuilderConfig, IClassUnitTestDefinition, IClassUnitTestRunOptions } from './adt/IUnitTestBuilderConfig';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,YAAY,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,YAAY,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAG3E,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,YAAY,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAG5E,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,YAAY,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGjD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,YAAY,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAGvE,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,cAAc,WAAW,CAAC;AAG1B,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,YAAY,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,YAAY,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAG3E,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,YAAY,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAG5E,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,YAAY,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGjD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,YAAY,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAGvE,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,cAAc,WAAW,CAAC;AAG1B,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACzE,YAAY,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,YAAY,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-abap-adt/interfaces",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Shared interfaces for MCP ABAP ADT packages",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",