@happyvertical/smrt-core 0.30.0

package/dist/manifest/sources/test.js

@@ -0,0 +1,21 @@
+import { shouldLoadCoreTestManifest, getTestManifestCache } from "../store.js";
+import { matchManifest, materializeEntry, manifestEntriesOf } from "./types.js";
+class TestManifestSource {
+  name = "test";
+  lookup(query) {
+    if (!shouldLoadCoreTestManifest()) return void 0;
+    const manifest = getTestManifestCache();
+    if (!manifest) return void 0;
+    const def = matchManifest(manifest, query);
+    if (!def) return void 0;
+    return materializeEntry(def, manifest, this.name);
+  }
+  *entries() {
+    if (!shouldLoadCoreTestManifest()) return;
+    yield* manifestEntriesOf(getTestManifestCache(), this.name);
+  }
+}
+export {
+  TestManifestSource
+};
+//# sourceMappingURL=test.js.map

package/dist/manifest/sources/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sources":["../../../src/manifest/sources/test.ts"],"sourcesContent":["/**\n * TestManifestSource — wraps `__smrtManifestTest`, the core-package test\n * manifest populated by the vitest setup when running smrt-core's own tests.\n *\n * Second priority in the composite in test environments. Inert in production.\n *\n * @see https://github.com/happyvertical/smrt/issues/1133\n */\n\nimport { getTestManifestCache, shouldLoadCoreTestManifest } from '../store.js';\nimport {\n  type ManifestEntry,\n  type ManifestLookupQuery,\n  type ManifestSource,\n  manifestEntriesOf,\n  matchManifest,\n  materializeEntry,\n} from './types.js';\n\nexport class TestManifestSource implements ManifestSource {\n  readonly name = 'test';\n\n  lookup(query: ManifestLookupQuery): ManifestEntry | undefined {\n    if (!shouldLoadCoreTestManifest()) return undefined;\n    const manifest = getTestManifestCache();\n    if (!manifest) return undefined;\n\n    const def = matchManifest(manifest, query);\n    if (!def) return undefined;\n    return materializeEntry(def, manifest, this.name);\n  }\n\n  *entries(): Iterable<ManifestEntry> {\n    if (!shouldLoadCoreTestManifest()) return;\n    yield* manifestEntriesOf(getTestManifestCache(), this.name);\n  }\n}\n"],"names":[],"mappings":";;AAmBO,MAAM,mBAA6C;AAAA,EAC/C,OAAO;AAAA,EAEhB,OAAO,OAAuD;AAC5D,QAAI,CAAC,2BAAA,EAA8B,QAAO;AAC1C,UAAM,WAAW,qBAAA;AACjB,QAAI,CAAC,SAAU,QAAO;AAEtB,UAAM,MAAM,cAAc,UAAU,KAAK;AACzC,QAAI,CAAC,IAAK,QAAO;AACjB,WAAO,iBAAiB,KAAK,UAAU,KAAK,IAAI;AAAA,EAClD;AAAA,EAEA,CAAC,UAAmC;AAClC,QAAI,CAAC,6BAA8B;AACnC,WAAO,kBAAkB,wBAAwB,KAAK,IAAI;AAAA,EAC5D;AACF;"}

package/dist/manifest/sources/types.d.ts

@@ -0,0 +1,79 @@
+import { SmartObjectDefinition, SmartObjectManifest } from '../../scanner/types.js';
+/**
+ * Inputs for a source lookup. Package- or qualified-name context wins over
+ * a bare simple name: implementations MUST prefer a qualified-name or
+ * package-scoped match when the query carries one, matching the historical
+ * semantics of `discoverManifestEntry()` in manifest-loader.ts.
+ *
+ * This is the contract that lets multi-package same-simple-name scenarios
+ * (issue #951) resolve to the right manifest entry when the caller has
+ * package identity available.
+ */
+export interface ManifestLookupQuery {
+    /** Simple class name. Always provided. */
+    className: string;
+    /** Package name for disambiguation. Preferred when caller has it. */
+    packageName?: string;
+    /** Fully qualified name (`@pkg:Class`). Takes precedence over className+packageName. */
+    qualifiedName?: string;
+}
+/** A manifest entry produced by a source, with provenance for diagnostics. */
+export interface ManifestEntry {
+    className: string;
+    qualifiedName?: string;
+    def: SmartObjectDefinition;
+    packageName?: string;
+    /** Which source (by `name`) produced this entry. */
+    source: string;
+}
+/**
+ * A cached or on-demand source of manifest entries.
+ *
+ * Four historical paths collapse onto this: `discoverManifestSync` (decorator-
+ * time sync lookup), `discoverManifestEntry` (async field hydration),
+ * `tryLoadFromExternalPackage` (async lazy load), and the cache lookups that
+ * were duplicated across both registry.ts and manifest-loader.ts.
+ */
+export interface ManifestSource {
+    /** Human-readable name for logging and diagnostics. */
+    readonly name: string;
+    /**
+     * Synchronous lookup. Must be a cache hit or a cheap sync fs read.
+     * Returns undefined when the source does not have the requested entry.
+     */
+    lookup(query: ManifestLookupQuery): ManifestEntry | undefined;
+    /**
+     * Enumerate every entry this source currently knows about. Used by the
+     * `loadAllManifests` replacement to register everything upfront, and by
+     * parity tests.
+     */
+    entries(): Iterable<ManifestEntry>;
+    /**
+     * Optional async hydration from a caller-provided hint. Used when a sync
+     * `lookup` misses but the caller has a package name or class name the
+     * source could try to populate itself from. Returns true when the source
+     * was successfully populated.
+     */
+    hydrate?(hint: {
+        packageName?: string;
+        className?: string;
+    }): Promise<boolean>;
+}
+/**
+ * Probe a single manifest for a lookup query, honoring the query's
+ * qualified-name / package-scoped preference before falling back to simple
+ * name matching. Used by every source that wraps one or more
+ * `SmartObjectManifest` values.
+ */
+export declare function matchManifest(manifest: SmartObjectManifest | null | undefined, query: ManifestLookupQuery): SmartObjectDefinition | undefined;
+/**
+ * Build a full ManifestEntry around a raw SmartObjectDefinition produced
+ * by `matchManifest`, attaching provenance and qualified-name derivation.
+ */
+export declare function materializeEntry(def: SmartObjectDefinition, manifest: SmartObjectManifest | null | undefined, sourceName: string): ManifestEntry;
+/**
+ * Convert a raw manifest's objects record into ManifestEntry iteration.
+ * Shared by every source that wraps a `SmartObjectManifest`.
+ */
+export declare function manifestEntriesOf(manifest: SmartObjectManifest | null | undefined, sourceName: string): Iterable<ManifestEntry>;
+//# sourceMappingURL=types.d.ts.map

package/dist/manifest/sources/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/manifest/sources/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAIhC;;;;;;;;;GASG;AACH,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wFAAwF;IACxF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,qBAAqB,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,aAAa,GAAG,SAAS,CAAC;IAE9D;;;;OAIG;IACH,OAAO,IAAI,QAAQ,CAAC,aAAa,CAAC,CAAC;IAEnC;;;;;OAKG;IACH,OAAO,CAAC,CAAC,IAAI,EAAE;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,EAChD,KAAK,EAAE,mBAAmB,GACzB,qBAAqB,GAAG,SAAS,CAuCnC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,qBAAqB,EAC1B,QAAQ,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,EAChD,UAAU,EAAE,MAAM,GACjB,aAAa,CAYf;AAED;;;GAGG;AACH,wBAAiB,iBAAiB,CAChC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,EAChD,UAAU,EAAE,MAAM,GACjB,QAAQ,CAAC,aAAa,CAAC,CAqBzB"}

package/dist/manifest/sources/types.js

@@ -0,0 +1,61 @@
+import { parseQualifiedName } from "../../utils/qualified-names.js";
+import { lookupCachedManifestEntry } from "../store.js";
+function matchManifest(manifest, query) {
+  if (!manifest?.objects) return void 0;
+  const queryPackage = query.packageName ?? (query.qualifiedName ? parseQualifiedName(query.qualifiedName).packageName : void 0);
+  if (queryPackage) {
+    if (manifest.packageName && manifest.packageName !== queryPackage) {
+      if (query.qualifiedName && manifest.objects[query.qualifiedName]) {
+        return manifest.objects[query.qualifiedName];
+      }
+      return void 0;
+    }
+    if (query.qualifiedName) {
+      const direct = manifest.objects[query.qualifiedName];
+      if (direct) return direct;
+    }
+    const qualified = `${queryPackage}:${query.className}`;
+    const scoped = manifest.objects[qualified];
+    if (scoped) return scoped;
+  }
+  return lookupCachedManifestEntry(
+    manifest,
+    query.qualifiedName ?? query.className
+  );
+}
+function materializeEntry(def, manifest, sourceName) {
+  const className = def.className ?? "";
+  const packageName = def.packageName ?? manifest?.packageName;
+  const qualifiedName = packageName && className ? `${packageName}:${className}` : void 0;
+  return {
+    className,
+    qualifiedName,
+    def,
+    packageName,
+    source: sourceName
+  };
+}
+function* manifestEntriesOf(manifest, sourceName) {
+  if (!manifest?.objects) {
+    return;
+  }
+  const packageName = manifest.packageName;
+  for (const [key, def] of Object.entries(manifest.objects)) {
+    if (!def) continue;
+    const className = def.className ?? key;
+    const qualifiedName = key.includes(":") ? key : packageName ? `${packageName}:${className}` : void 0;
+    yield {
+      className,
+      qualifiedName,
+      def,
+      packageName,
+      source: sourceName
+    };
+  }
+}
+export {
+  manifestEntriesOf,
+  matchManifest,
+  materializeEntry
+};
+//# sourceMappingURL=types.js.map

package/dist/manifest/sources/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":["../../../src/manifest/sources/types.ts"],"sourcesContent":["/**\n * ManifestSource abstraction — Release B consolidation of the four\n * overlapping discovery paths into a single pluggable interface.\n *\n * @see https://github.com/happyvertical/smrt/issues/1133\n */\n\nimport type {\n  SmartObjectDefinition,\n  SmartObjectManifest,\n} from '../../scanner/types.js';\nimport { parseQualifiedName } from '../../utils/qualified-names.js';\nimport { lookupCachedManifestEntry } from '../store.js';\n\n/**\n * Inputs for a source lookup. Package- or qualified-name context wins over\n * a bare simple name: implementations MUST prefer a qualified-name or\n * package-scoped match when the query carries one, matching the historical\n * semantics of `discoverManifestEntry()` in manifest-loader.ts.\n *\n * This is the contract that lets multi-package same-simple-name scenarios\n * (issue #951) resolve to the right manifest entry when the caller has\n * package identity available.\n */\nexport interface ManifestLookupQuery {\n  /** Simple class name. Always provided. */\n  className: string;\n  /** Package name for disambiguation. Preferred when caller has it. */\n  packageName?: string;\n  /** Fully qualified name (`@pkg:Class`). Takes precedence over className+packageName. */\n  qualifiedName?: string;\n}\n\n/** A manifest entry produced by a source, with provenance for diagnostics. */\nexport interface ManifestEntry {\n  className: string;\n  qualifiedName?: string;\n  def: SmartObjectDefinition;\n  packageName?: string;\n  /** Which source (by `name`) produced this entry. */\n  source: string;\n}\n\n/**\n * A cached or on-demand source of manifest entries.\n *\n * Four historical paths collapse onto this: `discoverManifestSync` (decorator-\n * time sync lookup), `discoverManifestEntry` (async field hydration),\n * `tryLoadFromExternalPackage` (async lazy load), and the cache lookups that\n * were duplicated across both registry.ts and manifest-loader.ts.\n */\nexport interface ManifestSource {\n  /** Human-readable name for logging and diagnostics. */\n  readonly name: string;\n\n  /**\n   * Synchronous lookup. Must be a cache hit or a cheap sync fs read.\n   * Returns undefined when the source does not have the requested entry.\n   */\n  lookup(query: ManifestLookupQuery): ManifestEntry | undefined;\n\n  /**\n   * Enumerate every entry this source currently knows about. Used by the\n   * `loadAllManifests` replacement to register everything upfront, and by\n   * parity tests.\n   */\n  entries(): Iterable<ManifestEntry>;\n\n  /**\n   * Optional async hydration from a caller-provided hint. Used when a sync\n   * `lookup` misses but the caller has a package name or class name the\n   * source could try to populate itself from. Returns true when the source\n   * was successfully populated.\n   */\n  hydrate?(hint: {\n    packageName?: string;\n    className?: string;\n  }): Promise<boolean>;\n}\n\n/**\n * Probe a single manifest for a lookup query, honoring the query's\n * qualified-name / package-scoped preference before falling back to simple\n * name matching. Used by every source that wraps one or more\n * `SmartObjectManifest` values.\n */\nexport function matchManifest(\n  manifest: SmartObjectManifest | null | undefined,\n  query: ManifestLookupQuery,\n): SmartObjectDefinition | undefined {\n  if (!manifest?.objects) return undefined;\n\n  // If the query carries package context, treat a mismatch as a hard miss.\n  // This is what preserves issue-#951's multi-package-same-simple-name\n  // semantics: an `@other/pkg:Widget` query must not resolve to\n  // `@acme/pkg:Widget` just because their simple names collide.\n  const queryPackage =\n    query.packageName ??\n    (query.qualifiedName\n      ? parseQualifiedName(query.qualifiedName).packageName\n      : undefined);\n\n  if (queryPackage) {\n    if (manifest.packageName && manifest.packageName !== queryPackage) {\n      // Wrong package. The only way to match is a direct qualified-key\n      // lookup (for aggregated manifests that contain cross-package entries).\n      if (query.qualifiedName && manifest.objects[query.qualifiedName]) {\n        return manifest.objects[query.qualifiedName] as SmartObjectDefinition;\n      }\n      return undefined;\n    }\n\n    // Right package (or manifest packageName unset). Prefer direct keys.\n    if (query.qualifiedName) {\n      const direct = manifest.objects[query.qualifiedName];\n      if (direct) return direct as SmartObjectDefinition;\n    }\n    const qualified = `${queryPackage}:${query.className}`;\n    const scoped = manifest.objects[qualified];\n    if (scoped) return scoped as SmartObjectDefinition;\n  }\n\n  // No package context, or package matched but no qualified hit: fall back\n  // to the lenient simple-name lookup that matches pre-Release-B behavior.\n  return lookupCachedManifestEntry(\n    manifest,\n    query.qualifiedName ?? query.className,\n  );\n}\n\n/**\n * Build a full ManifestEntry around a raw SmartObjectDefinition produced\n * by `matchManifest`, attaching provenance and qualified-name derivation.\n */\nexport function materializeEntry(\n  def: SmartObjectDefinition,\n  manifest: SmartObjectManifest | null | undefined,\n  sourceName: string,\n): ManifestEntry {\n  const className = def.className ?? '';\n  const packageName = def.packageName ?? manifest?.packageName;\n  const qualifiedName =\n    packageName && className ? `${packageName}:${className}` : undefined;\n  return {\n    className,\n    qualifiedName,\n    def,\n    packageName,\n    source: sourceName,\n  };\n}\n\n/**\n * Convert a raw manifest's objects record into ManifestEntry iteration.\n * Shared by every source that wraps a `SmartObjectManifest`.\n */\nexport function* manifestEntriesOf(\n  manifest: SmartObjectManifest | null | undefined,\n  sourceName: string,\n): Iterable<ManifestEntry> {\n  if (!manifest?.objects) {\n    return;\n  }\n  const packageName = manifest.packageName;\n  for (const [key, def] of Object.entries(manifest.objects)) {\n    if (!def) continue;\n    const className = (def as SmartObjectDefinition).className ?? key;\n    const qualifiedName = key.includes(':')\n      ? key\n      : packageName\n        ? `${packageName}:${className}`\n        : undefined;\n    yield {\n      className,\n      qualifiedName,\n      def: def as SmartObjectDefinition,\n      packageName,\n      source: sourceName,\n    };\n  }\n}\n"],"names":[],"mappings":";;AAsFO,SAAS,cACd,UACA,OACmC;AACnC,MAAI,CAAC,UAAU,QAAS,QAAO;AAM/B,QAAM,eACJ,MAAM,gBACL,MAAM,gBACH,mBAAmB,MAAM,aAAa,EAAE,cACxC;AAEN,MAAI,cAAc;AAChB,QAAI,SAAS,eAAe,SAAS,gBAAgB,cAAc;AAGjE,UAAI,MAAM,iBAAiB,SAAS,QAAQ,MAAM,aAAa,GAAG;AAChE,eAAO,SAAS,QAAQ,MAAM,aAAa;AAAA,MAC7C;AACA,aAAO;AAAA,IACT;AAGA,QAAI,MAAM,eAAe;AACvB,YAAM,SAAS,SAAS,QAAQ,MAAM,aAAa;AACnD,UAAI,OAAQ,QAAO;AAAA,IACrB;AACA,UAAM,YAAY,GAAG,YAAY,IAAI,MAAM,SAAS;AACpD,UAAM,SAAS,SAAS,QAAQ,SAAS;AACzC,QAAI,OAAQ,QAAO;AAAA,EACrB;AAIA,SAAO;AAAA,IACL;AAAA,IACA,MAAM,iBAAiB,MAAM;AAAA,EAAA;AAEjC;AAMO,SAAS,iBACd,KACA,UACA,YACe;AACf,QAAM,YAAY,IAAI,aAAa;AACnC,QAAM,cAAc,IAAI,eAAe,UAAU;AACjD,QAAM,gBACJ,eAAe,YAAY,GAAG,WAAW,IAAI,SAAS,KAAK;AAC7D,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,EAAA;AAEZ;AAMO,UAAU,kBACf,UACA,YACyB;AACzB,MAAI,CAAC,UAAU,SAAS;AACtB;AAAA,EACF;AACA,QAAM,cAAc,SAAS;AAC7B,aAAW,CAAC,KAAK,GAAG,KAAK,OAAO,QAAQ,SAAS,OAAO,GAAG;AACzD,QAAI,CAAC,IAAK;AACV,UAAM,YAAa,IAA8B,aAAa;AAC9D,UAAM,gBAAgB,IAAI,SAAS,GAAG,IAClC,MACA,cACE,GAAG,WAAW,IAAI,SAAS,KAC3B;AACN,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,QAAQ;AAAA,IAAA;AAAA,EAEZ;AACF;"}

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

@@ -0,0 +1,4 @@
+import { SmartObjectManifest } from '../scanner/types.js';
+export declare const staticManifest: SmartObjectManifest;
+export default staticManifest;
+//# sourceMappingURL=static-manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"static-manifest.d.ts","sourceRoot":"","sources":["../../src/manifest/static-manifest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,eAAO,MAAM,cAAc,EAAE,mBAg9CnB,CAAC;AAEX,eAAe,cAAc,CAAC"}