bridgelist 1.0.7 → 1.1.0

package/dist/utils/array-scanner.d.ts

@@ -0,0 +1,7 @@
+import { ArrayListDocumentationOptions } from "../types";
+import { MethodInfo } from './find-decorated-methods';
+export interface ArrayMethodInfo extends MethodInfo {
+    options: ArrayListDocumentationOptions;
+}
+export declare const arrayOptionsExtractor: import("./find-decorated-methods").OptionsExtractor<ArrayListDocumentationOptions>;
+export declare function scanProjectForArrayMethods(rootDir?: string): ArrayMethodInfo[];

package/dist/utils/array-scanner.js

@@ -0,0 +1,53 @@
+"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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrayOptionsExtractor = void 0;
+exports.scanProjectForArrayMethods = scanProjectForArrayMethods;
+const process = __importStar(require("node:process"));
+const find_decorated_methods_1 = require("./find-decorated-methods");
+exports.arrayOptionsExtractor = (0, find_decorated_methods_1.createOptionsExtractor)({
+    'title': 'title',
+    'description': 'description',
+    'destinationPath': 'destinationPath',
+    'outputPath': 'destinationPath',
+}, []);
+function scanProjectForArrayMethods(rootDir = process.cwd()) {
+    const methods = (0, find_decorated_methods_1.scanProjectForDecoratedMethods)(rootDir, {
+        decoratorName: 'GenerateArrayListDocumentation',
+        extractOptions: exports.arrayOptionsExtractor
+    });
+    return methods;
+}
+//# sourceMappingURL=array-scanner.js.map

package/dist/utils/array-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-scanner.js","sourceRoot":"","sources":["../../src/utils/array-scanner.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsBA,gEASC;AA/BD,sDAAwC;AAExC,qEAIkC;AAMrB,QAAA,qBAAqB,GAAG,IAAA,+CAAsB,EACvD;IACI,OAAO,EAAE,OAAO;IAChB,aAAa,EAAE,aAAa;IAC5B,iBAAiB,EAAE,iBAAiB;IACpC,YAAY,EAAE,iBAAwB;CACzC,EACD,EAAE,CACL,CAAC;AAEF,SAAgB,0BAA0B,CAAC,UAAkB,OAAO,CAAC,GAAG,EAAE;IACtE,MAAM,OAAO,GAAG,IAAA,uDAA8B,EAC1C,OAAO,EACP;QACI,aAAa,EAAE,gCAAgC;QAC/C,cAAc,EAAE,6BAAqB;KACxC,CACJ,CAAC;IACF,OAAO,OAA4B,CAAC;AACxC,CAAC"}

package/dist/utils/find-all-ts-files.d.ts

@@ -0,0 +1 @@
+export declare function findAllTsFiles(dir: string): string[];

package/dist/utils/find-all-ts-files.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findAllTsFiles = findAllTsFiles;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+function findAllTsFiles(dir) {
+    const files = [];
+    const entries = fs_1.default.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path_1.default.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name !== 'node_modules' && entry.name !== 'dist') {
+                files.push(...findAllTsFiles(fullPath));
+            }
+        }
+        else if (entry.isFile() && entry.name.endsWith('.ts') && !entry.name.endsWith('.d.ts')) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+//# sourceMappingURL=find-all-ts-files.js.map

package/dist/utils/find-all-ts-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-all-ts-files.js","sourceRoot":"","sources":["../../src/utils/find-all-ts-files.ts"],"names":[],"mappings":";;;;;AAGA,wCAgBC;AAnBD,4CAAoB;AACpB,gDAAwB;AAExB,SAAgB,cAAc,CAAC,GAAW;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,YAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAC,aAAa,EAAE,IAAI,EAAC,CAAC,CAAC;IAE3D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAE5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACtB,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACzD,KAAK,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC5C,CAAC;QACL,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACvF,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/utils/find-decorated-methods.d.ts

@@ -0,0 +1,16 @@
+import { SourceFile, Decorator, ObjectLiteralExpression } from 'ts-morph';
+export interface MethodInfo {
+    filePath: string;
+    className: string;
+    methodName: string;
+    options: any;
+}
+export type OptionsExtractor<T> = (decorator: Decorator) => T | null;
+export interface FindMethodsConfig<T> {
+    decoratorName: string;
+    extractOptions: OptionsExtractor<T>;
+}
+export declare function scanProjectForDecoratedMethods<T>(rootDir: string, config: FindMethodsConfig<T>): MethodInfo[];
+export declare function findDecoratedMethodsInFile<T>(sourceFile: SourceFile, config: FindMethodsConfig<T>): MethodInfo[];
+export declare function extractProperties<T>(objectLiteral: ObjectLiteralExpression, propertyMapping: Record<string, keyof T>, requiredProperties?: (keyof T)[]): T | null;
+export declare function createOptionsExtractor<T>(propertyMapping: Record<string, keyof T>, requiredProperties?: (keyof T)[]): OptionsExtractor<T>;

package/dist/utils/find-decorated-methods.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanProjectForDecoratedMethods = scanProjectForDecoratedMethods;
+exports.findDecoratedMethodsInFile = findDecoratedMethodsInFile;
+exports.extractProperties = extractProperties;
+exports.createOptionsExtractor = createOptionsExtractor;
+const ts_morph_1 = require("ts-morph");
+const find_all_ts_files_1 = require("./find-all-ts-files");
+function scanProjectForDecoratedMethods(rootDir, config) {
+    const results = [];
+    const project = new ts_morph_1.Project();
+    const tsFiles = (0, find_all_ts_files_1.findAllTsFiles)(rootDir);
+    project.addSourceFilesAtPaths(tsFiles);
+    for (const sourceFile of project.getSourceFiles()) {
+        const methods = findDecoratedMethodsInFile(sourceFile, config);
+        results.push(...methods);
+    }
+    return results;
+}
+function findDecoratedMethodsInFile(sourceFile, config) {
+    const { decoratorName, extractOptions } = config;
+    const methods = [];
+    try {
+        sourceFile.getClasses().forEach(classDecl => {
+            const className = classDecl.getName();
+            if (!className)
+                return;
+            classDecl.getMethods().forEach(method => {
+                const methodName = method.getName();
+                if (!methodName)
+                    return;
+                const decorator = method.getDecorator(decoratorName);
+                if (decorator) {
+                    const options = extractOptions(decorator);
+                    if (options) {
+                        methods.push({
+                            filePath: sourceFile.getFilePath(),
+                            className,
+                            methodName,
+                            options
+                        });
+                    }
+                }
+            });
+        });
+    }
+    catch (error) {
+        console.error(`Error analyzing file ${sourceFile.getFilePath()}:`, error);
+    }
+    return methods;
+}
+function extractProperties(objectLiteral, propertyMapping, requiredProperties = []) {
+    const result = {};
+    objectLiteral.getProperties().forEach((prop) => {
+        if (prop.getKind() === ts_morph_1.SyntaxKind.PropertyAssignment) {
+            const propAssignment = prop;
+            const propName = propAssignment.getName();
+            const initializer = propAssignment.getInitializer();
+            if (!initializer)
+                return;
+            if (propName in propertyMapping) {
+                const targetProp = propertyMapping[propName];
+                if (initializer.getKind() === ts_morph_1.SyntaxKind.StringLiteral) {
+                    const stringLiteral = initializer;
+                    const value = stringLiteral.getLiteralValue();
+                    result[targetProp] = value;
+                }
+                else if (initializer.getKind() === ts_morph_1.SyntaxKind.ArrayLiteralExpression) {
+                    const arrayLiteral = initializer;
+                    const elements = arrayLiteral.getElements()
+                        .filter(element => element.getKind() === ts_morph_1.SyntaxKind.StringLiteral)
+                        .map(element => element.getLiteralValue());
+                    result[targetProp] = elements;
+                }
+                else {
+                    result[targetProp] = initializer.getText();
+                }
+            }
+        }
+    });
+    for (const required of requiredProperties) {
+        if (result[required] === undefined) {
+            return null;
+        }
+    }
+    return result;
+}
+function createOptionsExtractor(propertyMapping, requiredProperties = []) {
+    return (decorator) => {
+        const callExpression = decorator.getCallExpression();
+        if (!callExpression)
+            return null;
+        const args = callExpression.getArguments();
+        if (args.length === 0)
+            return null;
+        const optionsArg = args[0];
+        if (optionsArg.getKind() !== ts_morph_1.SyntaxKind.ObjectLiteralExpression)
+            return null;
+        const objectLiteral = optionsArg;
+        return extractProperties(objectLiteral, propertyMapping, requiredProperties);
+    };
+}
+//# sourceMappingURL=find-decorated-methods.js.map

package/dist/utils/find-decorated-methods.js.map

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

package/dist/utils/mapping-scanner.d.ts

@@ -0,0 +1,7 @@
+import { MappingDocumentationOptions } from "../types";
+import { MethodInfo } from './find-decorated-methods';
+export interface MappingMethodInfo extends MethodInfo {
+    options: MappingDocumentationOptions;
+}
+export declare const mappingOptionsExtractor: import("./find-decorated-methods").OptionsExtractor<MappingDocumentationOptions>;
+export declare function scanProjectForMappingMethods(rootDir?: string): MappingMethodInfo[];

package/dist/utils/mapping-scanner.js

@@ -0,0 +1,53 @@
+"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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mappingOptionsExtractor = void 0;
+exports.scanProjectForMappingMethods = scanProjectForMappingMethods;
+const process = __importStar(require("node:process"));
+const find_decorated_methods_1 = require("./find-decorated-methods");
+exports.mappingOptionsExtractor = (0, find_decorated_methods_1.createOptionsExtractor)({
+    'sourceSystem': 'sourceSystem',
+    'targetSystem': 'targetSystem',
+    'destinationPath': 'destinationPath',
+    'description': 'description',
+}, ['sourceSystem', 'targetSystem']);
+function scanProjectForMappingMethods(rootDir = process.cwd()) {
+    const methods = (0, find_decorated_methods_1.scanProjectForDecoratedMethods)(rootDir, {
+        decoratorName: 'GenerateMappingDocumentation',
+        extractOptions: exports.mappingOptionsExtractor
+    });
+    return methods;
+}
+//# sourceMappingURL=mapping-scanner.js.map

package/dist/utils/mapping-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping-scanner.js","sourceRoot":"","sources":["../../src/utils/mapping-scanner.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBA,oEASC;AA/BD,sDAAwC;AAExC,qEAIkC;AAMrB,QAAA,uBAAuB,GAAG,IAAA,+CAAsB,EACzD;IACI,cAAc,EAAE,cAAc;IAC9B,cAAc,EAAE,cAAc;IAC9B,iBAAiB,EAAE,iBAAiB;IACpC,aAAa,EAAE,aAAa;CAC/B,EACD,CAAC,cAAc,EAAE,cAAc,CAAC,CACnC,CAAC;AAEF,SAAgB,4BAA4B,CAAC,UAAkB,OAAO,CAAC,GAAG,EAAE;IACxE,MAAM,OAAO,GAAG,IAAA,uDAA8B,EAC1C,OAAO,EACP;QACI,aAAa,EAAE,8BAA8B;QAC7C,cAAc,EAAE,+BAAuB;KAC1C,CACJ,CAAC;IACF,OAAO,OAA8B,CAAC;AAC1C,CAAC"}