@happyvertical/smrt-core 0.30.0

package/dist/manifest/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sources":["../../src/manifest/manager.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { createLogger } from '@happyvertical/logger';\nimport { ManifestGenerator } from '../scanner/manifest-generator.js';\nimport type { SmartObjectManifest } from '../scanner/types.js';\n\nconst logger = createLogger({ level: 'info' });\n\n/**\n * Reads, writes, and generates SMRT manifests for a project.\n *\n * @remarks\n * Manifests are JSON files containing class/field metadata produced by the AST scanner.\n * Dev manifests live at `.smrt/manifest.json`; build manifests at `dist/manifest.json`.\n * Workspace packages may also provide a checked-in source manifest at\n * `src/manifest/manifest.json`. When loading a local project, the dev path takes\n * priority; for external packages (dependencies), the build path takes priority\n * to avoid pulling in test objects.\n */\nexport class ManifestManager {\n  constructor(private projectRoot: string) {}\n\n  /**\n   * Get the standard output path for the manifest based on mode.\n   */\n  getOutputPath(mode: 'dev' | 'build' | 'source'): string {\n    if (mode === 'dev') {\n      return join(this.projectRoot, '.smrt/manifest.json');\n    }\n    if (mode === 'source') {\n      return join(this.projectRoot, 'src/manifest/manifest.json');\n    }\n    return join(this.projectRoot, 'dist/manifest.json');\n  }\n\n  /**\n   * Loads the local manifest from the standard locations.\n   * Priority: .smrt/manifest.json -> dist/manifest.json -> src/manifest/manifest.json\n   */\n  loadLocal(): SmartObjectManifest | null {\n    return this._loadFromPaths([\n      this.getOutputPath('dev'),\n      this.getOutputPath('build'),\n      this.getOutputPath('source'),\n    ]);\n  }\n\n  /**\n   * Loads the manifest for an external package (dependency).\n   * Priority: dist/manifest.json -> .smrt/manifest.json -> src/manifest/manifest.json\n   *\n   * External packages should prefer their production (dist) manifest\n   * over the dev/test (.smrt) manifest to avoid pulling in test objects\n   * and transitive dependencies. In a workspace, the checked-in source manifest\n   * provides the same package metadata even when the sibling package has not been built yet.\n   */\n  loadForExternalPackage(): SmartObjectManifest | null {\n    return this._loadFromPaths([\n      this.getOutputPath('build'),\n      this.getOutputPath('dev'),\n      this.getOutputPath('source'),\n    ]);\n  }\n\n  private _loadFromPaths(paths: string[]): SmartObjectManifest | null {\n    for (const path of paths) {\n      if (existsSync(path)) {\n        try {\n          const content = readFileSync(path, 'utf-8');\n          return JSON.parse(content);\n        } catch (error) {\n          logger.error(`[ManifestManager] Failed to read manifest at ${path}`, {\n            error,\n          });\n        }\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Writes a manifest to the standard location.\n   */\n  write(manifest: SmartObjectManifest, mode: 'dev' | 'build' = 'dev'): void {\n    const outputPath = this.getOutputPath(mode);\n    const outputDir = dirname(outputPath);\n\n    if (!existsSync(outputDir)) {\n      mkdirSync(outputDir, { recursive: true });\n    }\n\n    writeFileSync(outputPath, JSON.stringify(manifest, null, 2));\n  }\n\n  /**\n   * Generates a manifest from scan results and writes it.\n   */\n  async generateFromScanResults(\n    scanResults: any[],\n    options: {\n      mode: 'dev' | 'build';\n      packageName?: string;\n      packageVersion?: string;\n      packageJson?: any;\n      smrtDependencies?: string[];\n    },\n  ): Promise<SmartObjectManifest> {\n    const generator = new ManifestGenerator();\n    const manifest = generator.generateManifest(scanResults, options);\n    this.write(manifest, options.mode);\n    return manifest;\n  }\n}\n"],"names":[],"mappings":";;;;AAMA,MAAM,SAAS,aAAa,EAAE,OAAO,QAAQ;AAatC,MAAM,gBAAgB;AAAA,EAC3B,YAAoB,aAAqB;AAArB,SAAA,cAAA;AAAA,EAAsB;AAAA,EAAtB;AAAA;AAAA;AAAA;AAAA,EAKpB,cAAc,MAA0C;AACtD,QAAI,SAAS,OAAO;AAClB,aAAO,KAAK,KAAK,aAAa,qBAAqB;AAAA,IACrD;AACA,QAAI,SAAS,UAAU;AACrB,aAAO,KAAK,KAAK,aAAa,4BAA4B;AAAA,IAC5D;AACA,WAAO,KAAK,KAAK,aAAa,oBAAoB;AAAA,EACpD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,YAAwC;AACtC,WAAO,KAAK,eAAe;AAAA,MACzB,KAAK,cAAc,KAAK;AAAA,MACxB,KAAK,cAAc,OAAO;AAAA,MAC1B,KAAK,cAAc,QAAQ;AAAA,IAAA,CAC5B;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,yBAAqD;AACnD,WAAO,KAAK,eAAe;AAAA,MACzB,KAAK,cAAc,OAAO;AAAA,MAC1B,KAAK,cAAc,KAAK;AAAA,MACxB,KAAK,cAAc,QAAQ;AAAA,IAAA,CAC5B;AAAA,EACH;AAAA,EAEQ,eAAe,OAA6C;AAClE,eAAW,QAAQ,OAAO;AACxB,UAAI,WAAW,IAAI,GAAG;AACpB,YAAI;AACF,gBAAM,UAAU,aAAa,MAAM,OAAO;AAC1C,iBAAO,KAAK,MAAM,OAAO;AAAA,QAC3B,SAAS,OAAO;AACd,iBAAO,MAAM,gDAAgD,IAAI,IAAI;AAAA,YACnE;AAAA,UAAA,CACD;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,UAA+B,OAAwB,OAAa;AACxE,UAAM,aAAa,KAAK,cAAc,IAAI;AAC1C,UAAM,YAAY,QAAQ,UAAU;AAEpC,QAAI,CAAC,WAAW,SAAS,GAAG;AAC1B,gBAAU,WAAW,EAAE,WAAW,KAAA,CAAM;AAAA,IAC1C;AAEA,kBAAc,YAAY,KAAK,UAAU,UAAU,MAAM,CAAC,CAAC;AAAA,EAC7D;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,wBACJ,aACA,SAO8B;AAC9B,UAAM,YAAY,IAAI,kBAAA;AACtB,UAAM,WAAW,UAAU,iBAAiB,aAAa,OAAO;AAChE,SAAK,MAAM,UAAU,QAAQ,IAAI;AACjC,WAAO;AAAA,EACT;AACF;"}

package/dist/manifest/manifest-loader.d.ts

@@ -0,0 +1,187 @@
+import { FieldDefinition, MethodDefinition, SmartObjectDefinition, SmartObjectManifest } from '../scanner/types.js';
+/**
+ * Extend globalThis to include manifest loader state.
+ * Using globalThis ensures all module instances share the same manifest caches,
+ * which is critical in monorepos where the same package can be loaded
+ * from different paths (e.g., pnpm store vs workspace symlink).
+ *
+ * @see https://github.com/happyvertical/smrt/issues/543
+ */
+declare global {
+    var __smrtManifestStatic: SmartObjectManifest | null | undefined;
+    var __smrtManifestStaticLoadAttempted: boolean | undefined;
+    var __smrtManifestTest: SmartObjectManifest | null | undefined;
+    var __smrtManifestTestLoadAttempted: boolean | undefined;
+    var __smrtManifestCache: Map<string, SmartObjectManifest> | undefined;
+    var __smrtManifestLocalTest: SmartObjectManifest | null | undefined;
+    var __smrtManifestCollisions: Map<string, Array<{
+        packageName: string;
+        filePath?: string;
+        manifestSource: string;
+    }>> | undefined;
+    var __smrtSTISiblingCache: Map<string, Array<{
+        className: string;
+        entry: ManifestEntry;
+        packageName?: string;
+    }>> | undefined;
+}
+export type Manifest = SmartObjectManifest;
+export type ManifestEntry = SmartObjectDefinition;
+export type { FieldDefinition, MethodDefinition };
+/**
+ * Load local test manifest from current package (synchronous)
+ *
+ * During test runs, packages can have manifests in two locations:
+ * 1. src/manifest/test-manifest.json - Domain packages during development
+ * 2. dist/manifest.json - Built packages (consuming apps like praeco)
+ *
+ * This function attempts to load the manifest from either location.
+ *
+ * @returns Loaded manifest or null if not found or undefined if not yet attempted
+ */
+export declare function loadLocalTestManifestSync(): Manifest | null | undefined;
+/**
+ * Extract package name from class constructor
+ *
+ * Uses the ObjectRegistry (preferred) or fallback methods to determine
+ * which package the class belongs to.
+ *
+ * Search order:
+ * 1. ObjectRegistry (packageName injected at build time from manifest) - SKIPPED during initial registration
+ * 2. __package__ metadata (build tooling can inject this)
+ * 3. require.resolve() (resolves package.json from constructor file location)
+ * 4. Error stack trace parsing (fallback, fragile in pnpm workspaces)
+ *
+ * @param ctor - Class constructor
+ * @param skipRegistry - If true, skip checking ObjectRegistry (used during initial registration to avoid circular dependency)
+ * @returns Package name (e.g., '@happyvertical/smrt-places') or null
+ */
+export declare function getPackageName(ctor: new (...args: any[]) => any, skipRegistry?: boolean): string | null;
+interface ManifestLoadOptions {
+    warn?: boolean;
+}
+/**
+ * Load manifest from external package
+ *
+ * Uses createRequire from process.cwd() to resolve packages from the calling
+ * application's context, not from smrt-core's context. This allows finding
+ * packages that are dependencies of the app but not of smrt-core.
+ *
+ * External packages export manifests via package.json:
+ *   "exports": { "./manifest": "./dist/manifest.json" }
+ *
+ * @param packageName - Package name (e.g., '@happyvertical/smrt-places')
+ * @returns Manifest object or null if not found
+ */
+/**
+ * Load external package manifest synchronously
+ * This is the synchronous version of loadExternalManifest for use during class registration
+ */
+export declare function loadExternalManifestSync(packageName: string, options?: ManifestLoadOptions): Manifest | null;
+export declare function loadExternalManifest(packageName: string, options?: ManifestLoadOptions): Promise<Manifest | null>;
+/**
+ * Load a manifest directly from a known file path and cache it by package name.
+ *
+ * This is used by workspace/dev flows where sibling packages may not be
+ * installed into node_modules yet, but their generated manifests are still
+ * available on disk.
+ */
+export declare function loadManifestFromPathSync(manifestPath: string): Manifest | null;
+/**
+ * Discover manifest entry synchronously (checks only loaded manifests)
+ *
+ * Search order:
+ * 1. localTestManifest (for domain package test classes)
+ * 2. testManifest (for core test classes)
+ * 3. staticManifest (for core framework classes)
+ * 4. Cached external manifests
+ *
+ * @param className - Class name (for lookup)
+ * @returns ManifestEntry or undefined if not found
+ */
+export declare function discoverManifestSync(className: string): ManifestEntry | undefined;
+/**
+ * Look up a manifest entry in a manifest's objects map.
+ * Supports both qualified names and simple class names.
+ *
+ * Lookup order:
+ * 1. Direct qualified name lookup (e.g., "@happyvertical/smrt-core:Product")
+ * 2. Constructed qualified name (packageName + className)
+ * 3. Search by className property (case-insensitive)
+ *
+ * @param manifest - The manifest to search in
+ * @param nameOrQualified - Either a qualified name or simple class name
+ * @returns ManifestEntry or undefined if not found
+ */
+export declare function lookupInManifest(manifest: SmartObjectManifest, nameOrQualified: string): ManifestEntry | undefined;
+/**
+ * Find a manifest entry by qualified name across all loaded manifests.
+ *
+ * @param qualifiedName - The fully qualified class name (e.g., "@happyvertical/smrt-core:Product")
+ * @returns ManifestEntry or undefined if not found
+ */
+export declare function findManifestEntryByQualifiedName(qualifiedName: string): ManifestEntry | undefined;
+/**
+ * Discover manifest entry asynchronously (includes external package loading)
+ *
+ * Search order:
+ * 1. External package manifest (for constructor's package) - PRIORITIZED
+ * 2. testManifest (for test classes)
+ * 3. staticManifest (for core framework classes)
+ * 4. Cached external manifests
+ *
+ * This function now detects and reports class name collisions across packages.
+ *
+ * @param ctor - Class constructor
+ * @param className - Class name (for lookup)
+ * @returns ManifestEntry or undefined if not found
+ * @throws {Error} If class name collision detected across different packages
+ */
+export declare function discoverManifestEntry(ctor: new (...args: any[]) => any, className: string): Promise<ManifestEntry | undefined>;
+/**
+ * Get all detected manifest collisions
+ *
+ * @returns Map of class names to array of collision info
+ */
+export declare function getManifestCollisions(): Map<string, Array<{
+    packageName: string;
+    filePath?: string;
+    manifestSource: string;
+}>>;
+/**
+ * Clear manifest cache
+ *
+ * Useful for testing or when packages are updated at runtime.
+ */
+export declare function clearManifestCache(): void;
+/**
+ * Get all loaded manifests
+ *
+ * Returns a copy of the manifest cache for inspection.
+ *
+ * @returns Array of [packageName, manifest] entries
+ */
+export declare function getLoadedManifests(): Array<[string, Manifest]>;
+/**
+ * Discover all STI sibling classes that share the same collection (table)
+ *
+ * This is critical for STI schema merging: when one subtype is accessed,
+ * we need to discover ALL subtypes sharing the same table so that the
+ * database adapter receives a complete schema with all columns.
+ *
+ * Scans all available manifests:
+ * 1. Local test manifest (for test classes)
+ * 2. Test manifest (for core test classes)
+ * 3. Static manifest (for core framework classes)
+ * 4. Cached external manifests
+ * 5. SMRT dependencies from local test manifest
+ *
+ * @param collection - The collection/table name to find siblings for
+ * @returns Array of manifest entries that share the same collection
+ */
+export declare function discoverSTISiblingsSync(collection: string): Array<{
+    className: string;
+    entry: ManifestEntry;
+    packageName?: string;
+}>;
+//# sourceMappingURL=manifest-loader.d.ts.map

package/dist/manifest/manifest-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-loader.d.ts","sourceRoot":"","sources":["../../src/manifest/manifest-loader.ts"],"names":[],"mappings":"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"}