@memberjunction/codegen-lib 3.2.0 → 3.4.0

package/dist/Manifest/GenerateClassRegistrationsManifest.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Build-time tool to generate an import manifest that prevents tree-shaking of
+ * @RegisterClass decorated classes.
+ *
+ * The tool starts from the current app's package.json, walks its full transitive
+ * dependency tree, scans each dependency's source for @RegisterClass decorators,
+ * and generates a manifest importing only the packages that contain them.
+ *
+ * Usage (via MJCLI):
+ *   mj codegen manifest --output ./src/generated/class-registrations-manifest.ts
+ *
+ * Or programmatically:
+ *   import { generateClassRegistrationsManifest } from '@memberjunction/codegen-lib';
+ *   await generateClassRegistrationsManifest({ outputPath: './src/generated/class-manifest.ts' });
+ */
+/**
+ * Information about a class decorated with @RegisterClass
+ */
+export interface RegisteredClassInfo {
+    /** The class name */
+    className: string;
+    /** Absolute path to the source file */
+    filePath: string;
+    /** The npm package name (e.g., @memberjunction/core) */
+    packageName: string;
+    /** The base class name from the decorator (first argument) */
+    baseClassName?: string;
+    /** The key from the decorator (second argument) */
+    key?: string;
+}
+/**
+ * Options for the manifest generator
+ */
+export interface GenerateManifestOptions {
+    /**
+     * Output path for the generated manifest file.
+     */
+    outputPath: string;
+    /**
+     * Directory containing the app's package.json.
+     * Defaults to process.cwd().
+     */
+    appDir?: string;
+    /**
+     * If true, logs progress to console. Default: true
+     */
+    verbose?: boolean;
+    /**
+     * If provided, only include classes registered with these base classes.
+     * Example: ['BaseEngine', 'BaseAction']
+     */
+    filterBaseClasses?: string[];
+    /**
+     * Glob patterns to exclude from scanning.
+     */
+    excludePatterns?: string[];
+}
+/**
+ * Result of the manifest generation
+ */
+export interface GenerateManifestResult {
+    /** Whether generation was successful */
+    success: boolean;
+    /** Path to the generated manifest file */
+    outputPath: string;
+    /** All classes found */
+    classes: RegisteredClassInfo[];
+    /** Unique packages that will be imported */
+    packages: string[];
+    /** Total packages in the dependency tree */
+    totalDepsWalked: number;
+    /** Any errors encountered */
+    errors: string[];
+}
+/**
+ * Generates a class registrations manifest for the app in the given directory.
+ *
+ * Walks the app's dependency tree from its package.json, scans each dependency
+ * for @RegisterClass decorators, and writes an import manifest that prevents
+ * tree-shaking from removing those classes.
+ *
+ * @param options - Configuration options
+ * @returns Result with discovered classes and generated manifest path
+ *
+ * @example
+ * ```typescript
+ * import { generateClassRegistrationsManifest } from '@memberjunction/codegen-lib';
+ *
+ * const result = await generateClassRegistrationsManifest({
+ *     outputPath: './src/generated/class-manifest.ts'
+ * });
+ *
+ * if (result.success) {
+ *     console.log(`Manifest: ${result.packages.length} packages, ${result.classes.length} classes`);
+ * }
+ * ```
+ */
+export declare function generateClassRegistrationsManifest(options: GenerateManifestOptions): Promise<GenerateManifestResult>;
+//# sourceMappingURL=GenerateClassRegistrationsManifest.d.ts.map

package/dist/Manifest/GenerateClassRegistrationsManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GenerateClassRegistrationsManifest.d.ts","sourceRoot":"","sources":["../../src/Manifest/GenerateClassRegistrationsManifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE7B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB;AAolBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,kCAAkC,CACpD,OAAO,EAAE,uBAAuB,GACjC,OAAO,CAAC,sBAAsB,CAAC,CAsFjC"}