@abapify/adt-plugin-abapgit 0.4.0 → 0.4.1

package/dist/index.d.mts

@@ -0,0 +1,223 @@
+import { AbapObjectType, AdtPlugin, AdtPlugin as AdtPlugin$1, ExportContext, ExportResult, FormatPlugin, ImportContext, ImportResult } from "@abapify/adt-plugin";
+import { AdkObject } from "@abapify/adk";
+import { SchemaLike, TypedSchema } from "@abapify/ts-xsd";
+import { createAbapGitResolver as createFindingResolver } from "@abapify/adt-atc";
+
+//#region src/lib/format-plugin.d.ts
+declare const abapgitFormatPlugin: FormatPlugin;
+//#endregion
+//#region src/lib/folder-logic.d.ts
+/**
+ * abapGit Folder Logic
+ *
+ * Shared functions for resolving SAP package names from directory paths
+ * using abapGit's folder logic (PREFIX/FULL).
+ *
+ * Used by both the serializer (import: SAP → Git) and deserializer (export: Git → SAP).
+ */
+type FolderLogic = 'prefix' | 'full' | 'full-with-root';
+/**
+ * Parse abapGit repository metadata from .abapgit.xml content
+ */
+declare function parseAbapGitMetadata(xmlContent: string): {
+  folderLogic: FolderLogic;
+  startingFolder: string;
+};
+/**
+ * Reverse of calculatePackageDir — compute SAP package name from directory path
+ *
+ * Given a directory path relative to the starting folder, the folder logic,
+ * and the root package name, compute the SAP package name.
+ *
+ * PREFIX mode: root 'ZABAPGIT_EXAMPLES' + dir 'clas' → 'ZABAPGIT_EXAMPLES_CLAS'
+ * FULL mode: dir 'zabapgit_examples_clas' → 'ZABAPGIT_EXAMPLES_CLAS'
+ *
+ * @param dirPath - Directory path relative to starting folder
+ * @param folderLogic - Folder logic mode (prefix or full)
+ * @param rootPackage - Root SAP package name
+ * @returns SAP package name
+ */
+declare function resolvePackageFromDir(dirPath: string, folderLogic: FolderLogic, rootPackage: string): string;
+/**
+ * Reverse of resolvePackageFromDir — given a SAP package name and the
+ * relative directory of an object, back-derive the root package.
+ *
+ * PREFIX mode: sapPackage 'ZABAPGIT_EXAMPLES_FUGR' + dir 'fugr' → 'ZABAPGIT_EXAMPLES'
+ * FULL mode: cannot derive root (returns undefined)
+ *
+ * @param sapPackage - Actual SAP package name (from GET response)
+ * @param relDir - Directory path relative to starting folder
+ * @param folderLogic - Folder logic mode
+ * @returns Root package name, or undefined if it cannot be derived
+ */
+declare function reverseResolveRootPackage(sapPackage: string, relDir: string, folderLogic: FolderLogic): string | undefined;
+//#endregion
+//#region src/lib/abapgit.d.ts
+/**
+ * abapGit Plugin
+ *
+ * Provides import/export of ADK objects to abapGit repository format.
+ */
+declare const abapGitPlugin: AdtPlugin$1;
+//#endregion
+//#region src/lib/handlers/abapgit-schema.d.ts
+/**
+ * AbapGit schema instance with both full type and values type
+ *
+ * @typeParam TFull - Full AbapGitType (root XML structure)
+ * @typeParam TValues - Inner values type (e.g., DevcType)
+ * @typeParam S - Raw schema literal type
+ */
+interface AbapGitSchema<TFull, TValues, S extends SchemaLike = SchemaLike> extends TypedSchema<TFull, S> {
+  /** The inner values type - use with typeof for type extraction */
+  readonly _values: TValues;
+}
+/** Extract the values type from an AbapGitSchema */
+type InferValuesType<S> = S extends AbapGitSchema<unknown, infer V> ? V : unknown;
+//#endregion
+//#region src/lib/handlers/base.d.ts
+/**
+ * Extract the data type (D) from an AdkObject<K, D>
+ * This allows us to infer the payload type from the ADK class itself
+ */
+type InferAdkData<T> = T extends AdkObject<infer _K, infer D> ? D : never;
+/**
+ * ABAP object type code (e.g., 'CLAS', 'INTF', 'DOMA')
+ */
+type AbapObjectType$1 = string;
+/**
+ * Result of serializing a single file
+ */
+interface SerializedFile {
+  /** Relative path from object directory */
+  path: string;
+  /** File content */
+  content: string;
+  /** Optional encoding (default: utf-8) */
+  encoding?: BufferEncoding;
+}
+/**
+ * Handler interface for object serialization/deserialization
+ *
+ * @typeParam T - ADK object type
+ * @typeParam TSchema - AbapGit schema type (provides type-safe values)
+ */
+interface ObjectHandler<T extends AdkObject = AdkObject, TSchema extends AbapGitSchema<unknown, unknown> = AbapGitSchema<unknown, unknown>> {
+  /** ABAP object type (e.g., 'CLAS', 'INTF') */
+  readonly type: AbapObjectType$1;
+  /** File extension for this type (e.g., 'clas', 'intf') */
+  readonly fileExtension: string;
+  /** Schema for parsing/building XML */
+  readonly schema: TSchema;
+  /** Map abapGit file suffix to source key */
+  readonly suffixToSourceKey?: Record<string, string>;
+  /** Serialize object to files (SAP → Git) */
+  serialize(object: T): Promise<SerializedFile[]>;
+  /**
+   * Map abapGit values to ADK data (Git → SAP)
+   * Return type includes name (required) plus any ADK data fields
+   */
+  fromAbapGit?(values: InferValuesType<TSchema>): Partial<InferAdkData<T>> & {
+    name: string;
+  };
+  /**
+   * Set source files on ADK object during deserialization (Git → SAP)
+   * Symmetric counterpart to getSources
+   */
+  setSources?(object: T, sources: Record<string, string>): void;
+}
+/**
+ * Get handler for object type
+ *
+ * Tries the full type first (e.g., 'TABL/DS'), then falls back to the
+ * main type (e.g., 'CLAS/OC' → 'CLAS'). This matches ADK's resolveType()
+ * behaviour and handles quickSearch results that return subtypes.
+ */
+declare function getHandler(type: AbapObjectType$1): ObjectHandler | undefined;
+/**
+ * Check if object type is supported
+ *
+ * Tries the full type first, then falls back to the main type.
+ */
+declare function isSupported(type: AbapObjectType$1): boolean;
+/**
+ * Get all supported object types
+ */
+declare function getSupportedTypes(): AbapObjectType$1[];
+//#endregion
+//#region src/lib/deserializer.d.ts
+/**
+ * abapGit file naming convention:
+ * - XML metadata: {name}.{type}.xml (e.g., zcl_myclass.clas.xml)
+ * - Source code: {name}.{type}.abap (e.g., zcl_myclass.clas.abap)
+ * - Source includes: {name}.{type}.{suffix}.abap (e.g., zcl_myclass.clas.testclasses.abap)
+ */
+/**
+ * Parse abapGit filename to extract object info
+ */
+declare function parseAbapGitFilename(filename: string): {
+  name: string;
+  type: string;
+  suffix?: string;
+  extension: string;
+} | null;
+//#endregion
+//#region src/lib/filename/adt-uri-to-path.d.ts
+/**
+ * Convert an ADT URI to an on-disk abapGit filename.
+ *
+ * abapGit stores objects as `<name>.<type>.<ext>` inside `src/`.
+ * Classes have additional includes serialised as
+ * `<name>.clas.<suffix>.abap`. Function modules become
+ * `<group>.fugr.<fm_name>.abap`. Namespaces are rendered as
+ * `(namespace)name`.
+ *
+ * Returns `null` for URIs we don't recognise; callers may warn or fall
+ * back to a synthetic path.
+ */
+/**
+ * Convert an ADT URI to the abapGit on-disk filename (lower-cased,
+ * namespace-aware). Returns `null` when the URI shape is not recognised.
+ */
+declare function adtUriToAbapGitPath(uri: string): string | null;
+//#endregion
+//#region src/lib/handlers/xml-format.d.ts
+/**
+ * XML formatting utilities for abapGit serialization.
+ *
+ * Centralizes XML post-processing that was previously duplicated
+ * across base.ts, fugr.ts, tabl.ts, and roundtrip.ts.
+ *
+ * Uses indexOf-based parsing instead of regex to avoid
+ * super-linear backtracking (SonarQube S5852).
+ */
+/**
+ * Format XML attributes on separate lines for better diff readability.
+ *
+ * Turns `<tag a="1" b="2">` into:
+ * ```
+ * <tag
+ *   a="1"
+ *   b="2"
+ * >
+ * ```
+ *
+ * Uses indexOf-based scanning to avoid regex backtracking (S5852).
+ */
+declare function formatXmlAttributes(xml: string): string;
+/**
+ * Move `xmlns:asx` declaration from root `<abapGit>` to nested `<asx:abap>`.
+ *
+ * Uses indexOf-based approach instead of regex to avoid backtracking on
+ * the `[\s\S]*?` pattern that SonarQube flags.
+ */
+declare function moveNamespaceToAbap(xml: string): string;
+/**
+ * Apply standard abapGit XML formatting:
+ * 1. Format attributes on separate lines
+ * 2. Move xmlns:asx to asx:abap element
+ */
+declare function formatAbapGitXml(xml: string): string;
+//#endregion
+export { abapGitPlugin as AbapGitPlugin, abapGitPlugin, abapGitPlugin as default, type AbapObjectType, type AdtPlugin, type ExportContext, type ExportResult, type FolderLogic, type ImportContext, type ImportResult, type ObjectHandler, type SerializedFile, abapgitFormatPlugin, adtUriToAbapGitPath, createFindingResolver, formatAbapGitXml, formatXmlAttributes, getHandler, getSupportedTypes, isSupported, moveNamespaceToAbap, parseAbapGitFilename, parseAbapGitMetadata, resolvePackageFromDir, reverseResolveRootPackage };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/lib/format-plugin.ts","../src/lib/folder-logic.ts","../src/lib/abapgit.ts","../src/lib/handlers/abapgit-schema.ts","../src/lib/handlers/base.ts","../src/lib/deserializer.ts","../src/lib/filename/adt-uri-to-path.ts","../src/lib/handlers/xml-format.ts"],"mappings":";;;;;;cAoBa,mBAAA,EAAqB,YAAA;;;;;;;;;AAAlC;;KCXY,WAAA;;AA6CZ;;iBAAgB,oBAAA,CAAqB,UAAA;EACnC,WAAA,EAAa,WAAA;EACb,cAAA;AAAA;;;;;AAsBF;;;;;;;;;;iBAAgB,qBAAA,CACd,OAAA,UACA,WAAA,EAAa,WAAA,EACb,WAAA;;;;;;;;;;;;;iBA2Cc,yBAAA,CACd,UAAA,UACA,MAAA,UACA,WAAA,EAAa,WAAA;;;;;AD3Gf;;;cEmIa,aAAA,EAAe,WAAA;;;;;;;;;AD9I5B;UEYiB,aAAA,2BAGL,UAAA,GAAa,UAAA,UACf,WAAA,CAAY,KAAA,EAAO,CAAA;;WAElB,OAAA,EAAS,OAAA;AAAA;AFiGpB;AAAA,KEtDY,eAAA,MACV,CAAA,SAAU,aAAA,qBAAkC,CAAA;;;;;;;KCnDlC,YAAA,MACV,CAAA,SAAU,SAAA,sBAA+B,CAAA;;;;KAsB/B,gBAAA;;AHmCZ;;UG9BiB,cAAA;EHgCS;EG9BxB,IAAA;EH8Ba;EG5Bb,OAAA;EH6BA;EG3BA,QAAA,GAAW,cAAA;AAAA;AHsEb;;;;;;AAAA,UG7DiB,aAAA,WACL,SAAA,GAAY,SAAA,kBACN,aAAA,qBAAkC,aAAA;EH8DlD;EAAA,SGxDS,IAAA,EAAM,gBAAA;EHwDS;EAAA,SGtDf,aAAA;;WAEA,MAAA,EAAQ,OAAA;EF4EN;EAAA,SE1EF,iBAAA,GAAoB,MAAA;;EAE7B,SAAA,CAAU,MAAA,EAAQ,CAAA,GAAI,OAAA,CAAQ,cAAA;EFuN9B;;;;EElNA,WAAA,EACE,MAAA,EAAQ,eAAA,CAAgB,OAAA,IACvB,OAAA,CAAQ,YAAA,CAAa,CAAA;IAAQ,IAAA;EAAA;ED9DtB;;;;ECoEV,UAAA,EAAY,MAAA,EAAQ,CAAA,EAAG,OAAA,EAAS,MAAA;AAAA;;;;;;;;iBAyBlB,UAAA,CAAW,IAAA,EAAM,gBAAA,GAAiB,aAAA;;;AD/ClD;;;iBCwDgB,WAAA,CAAY,IAAA,EAAM,gBAAA;;;;iBAOlB,iBAAA,CAAA,GAAqB,gBAAA;;;;;;AH5HrC;;;;;AA6CA;iBIvBgB,oBAAA,CAAqB,QAAA;EACnC,IAAA;EACA,IAAA;EACA,MAAA;EACA,SAAA;AAAA;;;;;;;;;ALfF;;;;;;;;ACXA;;iBKwKgB,mBAAA,CAAoB,GAAA;;;;;;;;;AN7JpC;;;;;;;;ACXA;;;;;AA6CA;;;iBMGgB,mBAAA,CAAoB,GAAA;;;;;;;iBA8DpB,mBAAA,CAAoB,GAAA;;;;;;iBA8BpB,gBAAA,CAAiB,GAAA"}