@happyvertical/smrt-core 0.30.0

package/dist/utils/json.js

@@ -0,0 +1,43 @@
+import { JSONFactory } from "@happyvertical/json";
+let adapter = null;
+function getAdapter() {
+  if (!adapter) {
+    adapter = JSONFactory.create({
+      adapter: "auto",
+      // Use SIMD when available, fallback to native
+      fallback: true
+    });
+  }
+  return adapter;
+}
+function parse(text) {
+  return getAdapter().parse(text);
+}
+function stringify(value, replacer, space) {
+  return getAdapter().stringify(value, replacer, space);
+}
+function clone(value) {
+  return getAdapter().clone(value);
+}
+function safeParse(text) {
+  return getAdapter().safeParse(text);
+}
+function safeStringify(value) {
+  return getAdapter().safeStringify(value);
+}
+function isValid(text) {
+  return getAdapter().isValid(text);
+}
+function getAdapterInfo() {
+  return getAdapter().getInfo();
+}
+export {
+  clone,
+  getAdapterInfo,
+  isValid,
+  parse,
+  safeParse,
+  safeStringify,
+  stringify
+};
+//# sourceMappingURL=json.js.map

package/dist/utils/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sources":["../../src/utils/json.ts"],"sourcesContent":["/**\n * JSON utilities with optional SIMD acceleration\n *\n * Uses @happyvertical/json for faster parsing when available,\n * with automatic fallback to native JSON.\n *\n * Performance: 2-3x faster parsing on large JSON files (680KB manifests)\n */\n\nimport {\n  type JSONAdapter,\n  JSONFactory,\n  type ParseError,\n  type Result,\n  type StringifyError,\n} from '@happyvertical/json';\n\n// Singleton adapter instance\nlet adapter: JSONAdapter | null = null;\n\n/**\n * Get or create the JSON adapter instance\n */\nfunction getAdapter(): JSONAdapter {\n  if (!adapter) {\n    adapter = JSONFactory.create({\n      adapter: 'auto', // Use SIMD when available, fallback to native\n      fallback: true,\n    });\n  }\n  return adapter;\n}\n\n/**\n * Parse JSON string with optional SIMD acceleration\n *\n * @example\n * ```typescript\n * import { parse } from '@happyvertical/smrt-core/utils/json';\n *\n * const data = parse<MyType>('{\"key\": \"value\"}');\n * ```\n */\nexport function parse<T = unknown>(text: string): T {\n  return getAdapter().parse<T>(text);\n}\n\n/**\n * Stringify value to JSON with optional SIMD acceleration\n *\n * @example\n * ```typescript\n * import { stringify } from '@happyvertical/smrt-core/utils/json';\n *\n * const json = stringify({ key: 'value' });\n * const pretty = stringify({ key: 'value' }, null, 2);\n * ```\n */\nexport function stringify(\n  value: unknown,\n  replacer?:\n    | ((key: string, value: unknown) => unknown)\n    | (string | number)[]\n    | null,\n  space?: number | string,\n): string {\n  return getAdapter().stringify(value, replacer as any, space as any);\n}\n\n/**\n * Deep clone via JSON round-trip with optional SIMD acceleration\n *\n * @example\n * ```typescript\n * import { clone } from '@happyvertical/smrt-core/utils/json';\n *\n * const copy = clone(original);\n * ```\n */\nexport function clone<T>(value: T): T {\n  return getAdapter().clone(value);\n}\n\n/**\n * Parse JSON without throwing - returns Result type\n *\n * @example\n * ```typescript\n * import { safeParse } from '@happyvertical/smrt-core/utils/json';\n *\n * const result = safeParse<Config>(configJson);\n * if (result.success) {\n *   console.log(result.value);\n * } else {\n *   console.error(result.error.message);\n * }\n * ```\n */\nexport function safeParse<T = unknown>(text: string): Result<T, ParseError> {\n  return getAdapter().safeParse<T>(text);\n}\n\n/**\n * Stringify without throwing - returns Result type\n *\n * @example\n * ```typescript\n * import { safeStringify } from '@happyvertical/smrt-core/utils/json';\n *\n * const result = safeStringify(data);\n * if (result.success) {\n *   console.log(result.value);\n * } else {\n *   console.error(result.error.message);\n * }\n * ```\n */\nexport function safeStringify(value: unknown): Result<string, StringifyError> {\n  return getAdapter().safeStringify(value);\n}\n\n/**\n * Check if a string is valid JSON\n *\n * @example\n * ```typescript\n * import { isValid } from '@happyvertical/smrt-core/utils/json';\n *\n * if (isValid(userInput)) {\n *   // Safe to parse\n * }\n * ```\n */\nexport function isValid(text: string): boolean {\n  return getAdapter().isValid(text);\n}\n\n/**\n * Get information about the active JSON adapter\n *\n * @example\n * ```typescript\n * import { getAdapterInfo } from '@happyvertical/smrt-core/utils/json';\n *\n * const info = getAdapterInfo();\n * console.log(`Using ${info.name} adapter, SIMD: ${info.simdEnabled}`);\n * ```\n */\nexport function getAdapterInfo(): {\n  name: string;\n  isNative: boolean;\n  version?: string;\n  simdEnabled?: boolean;\n} {\n  return getAdapter().getInfo();\n}\n\n/**\n * Re-export types for convenience\n */\nexport type { JSONAdapter, ParseError, Result, StringifyError };\n"],"names":[],"mappings":";AAkBA,IAAI,UAA8B;AAKlC,SAAS,aAA0B;AACjC,MAAI,CAAC,SAAS;AACZ,cAAU,YAAY,OAAO;AAAA,MAC3B,SAAS;AAAA;AAAA,MACT,UAAU;AAAA,IAAA,CACX;AAAA,EACH;AACA,SAAO;AACT;AAYO,SAAS,MAAmB,MAAiB;AAClD,SAAO,WAAA,EAAa,MAAS,IAAI;AACnC;AAaO,SAAS,UACd,OACA,UAIA,OACQ;AACR,SAAO,WAAA,EAAa,UAAU,OAAO,UAAiB,KAAY;AACpE;AAYO,SAAS,MAAS,OAAa;AACpC,SAAO,WAAA,EAAa,MAAM,KAAK;AACjC;AAiBO,SAAS,UAAuB,MAAqC;AAC1E,SAAO,WAAA,EAAa,UAAa,IAAI;AACvC;AAiBO,SAAS,cAAc,OAAgD;AAC5E,SAAO,WAAA,EAAa,cAAc,KAAK;AACzC;AAcO,SAAS,QAAQ,MAAuB;AAC7C,SAAO,WAAA,EAAa,QAAQ,IAAI;AAClC;AAaO,SAAS,iBAKd;AACA,SAAO,WAAA,EAAa,QAAA;AACtB;"}

package/dist/utils/lru-cache.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Simple LRU (Least Recently Used) Cache implementation
+ *
+ * Automatically evicts least recently used entries when size limit is reached.
+ * Useful for preventing memory leaks in long-running applications.
+ */
+export declare class LRUCache<K, V> {
+    private cache;
+    private readonly maxSize;
+    /**
+     * Create an LRU cache with a maximum size
+     *
+     * @param maxSize - Maximum number of entries to store (default: 100)
+     */
+    constructor(maxSize?: number);
+    /**
+     * Get a value from the cache
+     * Marks the entry as recently used (moves to end of Map)
+     *
+     * @param key - Cache key
+     * @returns Value if found, undefined otherwise
+     */
+    get(key: K): V | undefined;
+    /**
+     * Set a value in the cache
+     * Evicts least recently used entry if cache is full
+     *
+     * @param key - Cache key
+     * @param value - Value to store
+     */
+    set(key: K, value: V): void;
+    /**
+     * Check if key exists in cache
+     *
+     * @param key - Cache key
+     * @returns True if key exists
+     */
+    has(key: K): boolean;
+    /**
+     * Remove an entry from the cache
+     *
+     * @param key - Cache key
+     * @returns True if entry was removed, false if not found
+     */
+    delete(key: K): boolean;
+    /**
+     * Clear all entries from the cache
+     */
+    clear(): void;
+    /**
+     * Get current cache size
+     *
+     * @returns Number of entries in cache
+     */
+    get size(): number;
+    /**
+     * Get all keys in the cache (least to most recently used)
+     *
+     * @returns Array of keys
+     */
+    keys(): K[];
+    /**
+     * Get all values in the cache (least to most recently used)
+     *
+     * @returns Array of values
+     */
+    values(): V[];
+}
+//# sourceMappingURL=lru-cache.d.ts.map

package/dist/utils/lru-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru-cache.d.ts","sourceRoot":"","sources":["../../src/utils/lru-cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,QAAQ,CAAC,CAAC,EAAE,CAAC;IACxB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC;;;;OAIG;gBACS,OAAO,SAAM;IAKzB;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAa1B;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAmB3B;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIpB;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIvB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACH,IAAI,IAAI,CAAC,EAAE;IAIX;;;;OAIG;IACH,MAAM,IAAI,CAAC,EAAE;CAGd"}

package/dist/utils/lru-cache.js

@@ -0,0 +1,100 @@
+class LRUCache {
+  cache;
+  maxSize;
+  /**
+   * Create an LRU cache with a maximum size
+   *
+   * @param maxSize - Maximum number of entries to store (default: 100)
+   */
+  constructor(maxSize = 100) {
+    this.cache = /* @__PURE__ */ new Map();
+    this.maxSize = maxSize;
+  }
+  /**
+   * Get a value from the cache
+   * Marks the entry as recently used (moves to end of Map)
+   *
+   * @param key - Cache key
+   * @returns Value if found, undefined otherwise
+   */
+  get(key) {
+    if (!this.cache.has(key)) {
+      return void 0;
+    }
+    const value = this.cache.get(key);
+    this.cache.delete(key);
+    this.cache.set(key, value);
+    return value;
+  }
+  /**
+   * Set a value in the cache
+   * Evicts least recently used entry if cache is full
+   *
+   * @param key - Cache key
+   * @param value - Value to store
+   */
+  set(key, value) {
+    if (this.cache.has(key)) {
+      this.cache.delete(key);
+    }
+    if (this.cache.size >= this.maxSize) {
+      const firstKey = this.cache.keys().next().value;
+      if (firstKey !== void 0) {
+        this.cache.delete(firstKey);
+      }
+    }
+    this.cache.set(key, value);
+  }
+  /**
+   * Check if key exists in cache
+   *
+   * @param key - Cache key
+   * @returns True if key exists
+   */
+  has(key) {
+    return this.cache.has(key);
+  }
+  /**
+   * Remove an entry from the cache
+   *
+   * @param key - Cache key
+   * @returns True if entry was removed, false if not found
+   */
+  delete(key) {
+    return this.cache.delete(key);
+  }
+  /**
+   * Clear all entries from the cache
+   */
+  clear() {
+    this.cache.clear();
+  }
+  /**
+   * Get current cache size
+   *
+   * @returns Number of entries in cache
+   */
+  get size() {
+    return this.cache.size;
+  }
+  /**
+   * Get all keys in the cache (least to most recently used)
+   *
+   * @returns Array of keys
+   */
+  keys() {
+    return Array.from(this.cache.keys());
+  }
+  /**
+   * Get all values in the cache (least to most recently used)
+   *
+   * @returns Array of values
+   */
+  values() {
+    return Array.from(this.cache.values());
+  }
+}
+export {
+  LRUCache
+};
+//# sourceMappingURL=lru-cache.js.map

package/dist/utils/lru-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru-cache.js","sources":["../../src/utils/lru-cache.ts"],"sourcesContent":["/**\n * Simple LRU (Least Recently Used) Cache implementation\n *\n * Automatically evicts least recently used entries when size limit is reached.\n * Useful for preventing memory leaks in long-running applications.\n */\nexport class LRUCache<K, V> {\n  private cache: Map<K, V>;\n  private readonly maxSize: number;\n\n  /**\n   * Create an LRU cache with a maximum size\n   *\n   * @param maxSize - Maximum number of entries to store (default: 100)\n   */\n  constructor(maxSize = 100) {\n    this.cache = new Map();\n    this.maxSize = maxSize;\n  }\n\n  /**\n   * Get a value from the cache\n   * Marks the entry as recently used (moves to end of Map)\n   *\n   * @param key - Cache key\n   * @returns Value if found, undefined otherwise\n   */\n  get(key: K): V | undefined {\n    if (!this.cache.has(key)) {\n      return undefined;\n    }\n\n    // Move to end (most recently used)\n    const value = this.cache.get(key)!;\n    this.cache.delete(key);\n    this.cache.set(key, value);\n\n    return value;\n  }\n\n  /**\n   * Set a value in the cache\n   * Evicts least recently used entry if cache is full\n   *\n   * @param key - Cache key\n   * @param value - Value to store\n   */\n  set(key: K, value: V): void {\n    // Remove if exists (will re-add at end)\n    if (this.cache.has(key)) {\n      this.cache.delete(key);\n    }\n\n    // Evict least recently used entry if at capacity\n    if (this.cache.size >= this.maxSize) {\n      // First entry is least recently used (Map maintains insertion order)\n      const firstKey = this.cache.keys().next().value;\n      if (firstKey !== undefined) {\n        this.cache.delete(firstKey);\n      }\n    }\n\n    // Add as most recently used (at end)\n    this.cache.set(key, value);\n  }\n\n  /**\n   * Check if key exists in cache\n   *\n   * @param key - Cache key\n   * @returns True if key exists\n   */\n  has(key: K): boolean {\n    return this.cache.has(key);\n  }\n\n  /**\n   * Remove an entry from the cache\n   *\n   * @param key - Cache key\n   * @returns True if entry was removed, false if not found\n   */\n  delete(key: K): boolean {\n    return this.cache.delete(key);\n  }\n\n  /**\n   * Clear all entries from the cache\n   */\n  clear(): void {\n    this.cache.clear();\n  }\n\n  /**\n   * Get current cache size\n   *\n   * @returns Number of entries in cache\n   */\n  get size(): number {\n    return this.cache.size;\n  }\n\n  /**\n   * Get all keys in the cache (least to most recently used)\n   *\n   * @returns Array of keys\n   */\n  keys(): K[] {\n    return Array.from(this.cache.keys());\n  }\n\n  /**\n   * Get all values in the cache (least to most recently used)\n   *\n   * @returns Array of values\n   */\n  values(): V[] {\n    return Array.from(this.cache.values());\n  }\n}\n"],"names":[],"mappings":"AAMO,MAAM,SAAe;AAAA,EAClB;AAAA,EACS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOjB,YAAY,UAAU,KAAK;AACzB,SAAK,4BAAY,IAAA;AACjB,SAAK,UAAU;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,IAAI,KAAuB;AACzB,QAAI,CAAC,KAAK,MAAM,IAAI,GAAG,GAAG;AACxB,aAAO;AAAA,IACT;AAGA,UAAM,QAAQ,KAAK,MAAM,IAAI,GAAG;AAChC,SAAK,MAAM,OAAO,GAAG;AACrB,SAAK,MAAM,IAAI,KAAK,KAAK;AAEzB,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,IAAI,KAAQ,OAAgB;AAE1B,QAAI,KAAK,MAAM,IAAI,GAAG,GAAG;AACvB,WAAK,MAAM,OAAO,GAAG;AAAA,IACvB;AAGA,QAAI,KAAK,MAAM,QAAQ,KAAK,SAAS;AAEnC,YAAM,WAAW,KAAK,MAAM,KAAA,EAAO,OAAO;AAC1C,UAAI,aAAa,QAAW;AAC1B,aAAK,MAAM,OAAO,QAAQ;AAAA,MAC5B;AAAA,IACF;AAGA,SAAK,MAAM,IAAI,KAAK,KAAK;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAI,KAAiB;AACnB,WAAO,KAAK,MAAM,IAAI,GAAG;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,KAAiB;AACtB,WAAO,KAAK,MAAM,OAAO,GAAG;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA,EAKA,QAAc;AACZ,SAAK,MAAM,MAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,IAAI,OAAe;AACjB,WAAO,KAAK,MAAM;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAY;AACV,WAAO,MAAM,KAAK,KAAK,MAAM,MAAM;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,SAAc;AACZ,WAAO,MAAM,KAAK,KAAK,MAAM,QAAQ;AAAA,EACvC;AACF;"}

package/dist/utils/naming.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Converts a camelCase string to snake_case.
+ */
+export declare function toSnakeCase(str: string): string;
+/**
+ * Pluralizes an English word using the pluralize library.
+ *
+ * For snake_case table names with multiple words, only the last word is
+ * pluralized: `journal_entry` -> `journal_entries`.
+ */
+export declare function pluralize(word: string): string;
+/**
+ * Converts a class name to a pluralized snake_case table name.
+ */
+export declare function classnameToTablename(className: string): string;
+//# sourceMappingURL=naming.d.ts.map

package/dist/utils/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../src/utils/naming.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS9C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAI9D"}

package/dist/utils/naming.js

@@ -0,0 +1,23 @@
+import pluralizeLib from "pluralize";
+function toSnakeCase(str) {
+  return str.replace(/([A-Z])/g, "_$1").toLowerCase().replace(/^_/, "");
+}
+function pluralize(word) {
+  if (word.includes("_")) {
+    const parts = word.split("_");
+    const lastWord = parts.pop();
+    if (!lastWord) return word;
+    return [...parts, pluralizeLib(lastWord)].join("_");
+  }
+  return pluralizeLib(word);
+}
+function classnameToTablename(className) {
+  const snakeCase = className.replace(/([a-z])([A-Z])/g, "$1_$2").toLowerCase();
+  return pluralize(snakeCase);
+}
+export {
+  classnameToTablename,
+  pluralize,
+  toSnakeCase
+};
+//# sourceMappingURL=naming.js.map

package/dist/utils/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sources":["../../src/utils/naming.ts"],"sourcesContent":["import pluralizeLib from 'pluralize';\n\n/**\n * Converts a camelCase string to snake_case.\n */\nexport function toSnakeCase(str: string): string {\n  return str\n    .replace(/([A-Z])/g, '_$1')\n    .toLowerCase()\n    .replace(/^_/, '');\n}\n\n/**\n * Pluralizes an English word using the pluralize library.\n *\n * For snake_case table names with multiple words, only the last word is\n * pluralized: `journal_entry` -> `journal_entries`.\n */\nexport function pluralize(word: string): string {\n  if (word.includes('_')) {\n    const parts = word.split('_');\n    const lastWord = parts.pop();\n    if (!lastWord) return word;\n    return [...parts, pluralizeLib(lastWord)].join('_');\n  }\n\n  return pluralizeLib(word);\n}\n\n/**\n * Converts a class name to a pluralized snake_case table name.\n */\nexport function classnameToTablename(className: string): string {\n  const snakeCase = className.replace(/([a-z])([A-Z])/g, '$1_$2').toLowerCase();\n\n  return pluralize(snakeCase);\n}\n"],"names":[],"mappings":";AAKO,SAAS,YAAY,KAAqB;AAC/C,SAAO,IACJ,QAAQ,YAAY,KAAK,EACzB,cACA,QAAQ,MAAM,EAAE;AACrB;AAQO,SAAS,UAAU,MAAsB;AAC9C,MAAI,KAAK,SAAS,GAAG,GAAG;AACtB,UAAM,QAAQ,KAAK,MAAM,GAAG;AAC5B,UAAM,WAAW,MAAM,IAAA;AACvB,QAAI,CAAC,SAAU,QAAO;AACtB,WAAO,CAAC,GAAG,OAAO,aAAa,QAAQ,CAAC,EAAE,KAAK,GAAG;AAAA,EACpD;AAEA,SAAO,aAAa,IAAI;AAC1B;AAKO,SAAS,qBAAqB,WAA2B;AAC9D,QAAM,YAAY,UAAU,QAAQ,mBAAmB,OAAO,EAAE,YAAA;AAEhE,SAAO,UAAU,SAAS;AAC5B;"}

package/dist/utils/qualified-names.d.ts

@@ -0,0 +1,122 @@
+import { QualifiedClassName } from '../scanner/types.js';
+/**
+ * Creates a qualified class name from package name and class name.
+ *
+ * @param packageName - The npm package name (e.g., "@happyvertical/smrt-core")
+ * @param className - The class name (e.g., "Product")
+ * @returns Qualified name in format "@package/name:ClassName"
+ *
+ * @example
+ * createQualifiedName('@happyvertical/smrt-core', 'Product')
+ * // Returns: "@happyvertical/smrt-core:Product"
+ */
+export declare function createQualifiedName(packageName: string, className: string): QualifiedClassName;
+/**
+ * Result of parsing a qualified class name.
+ */
+export interface ParsedQualifiedName {
+    /** The package name (e.g., "@happyvertical/smrt-core") */
+    packageName: string;
+    /** The class name (e.g., "Product") */
+    className: string;
+}
+/**
+ * Parses a qualified class name into its components.
+ *
+ * @param qualifiedName - The qualified name to parse
+ * @returns Object with packageName and className
+ * @throws Error if the name is not a valid qualified name
+ *
+ * @example
+ * parseQualifiedName('@happyvertical/smrt-core:Product')
+ * // Returns: { packageName: '@happyvertical/smrt-core', className: 'Product' }
+ */
+export declare function parseQualifiedName(qualifiedName: string): ParsedQualifiedName;
+/**
+ * Checks if a name is a valid qualified class name.
+ *
+ * A valid qualified name:
+ * - Contains a colon (:) separating package and class
+ * - Has a package name with a forward slash (scoped npm package)
+ * - Has a non-empty class name after the colon
+ *
+ * @param name - The name to check
+ * @returns true if the name is a valid qualified class name
+ *
+ * @example
+ * isQualifiedName('@happyvertical/smrt-core:Product') // true
+ * isQualifiedName('Product') // false
+ * isQualifiedName('smrt-core:Product') // false (no @ scope)
+ */
+export declare function isQualifiedName(name: string): name is QualifiedClassName;
+/**
+ * Extracts just the class name from a qualified name or simple name.
+ * Useful when you need the class name regardless of whether
+ * the input is qualified or not.
+ *
+ * @param name - Qualified name or simple class name
+ * @returns The simple class name
+ *
+ * @example
+ * getClassName('@happyvertical/smrt-core:Product') // 'Product'
+ * getClassName('Product') // 'Product'
+ */
+export declare function getClassName(name: string): string;
+/**
+ * Extracts the package name from a qualified name.
+ * Returns undefined if the name is not qualified.
+ *
+ * @param name - Qualified name or simple class name
+ * @returns The package name, or undefined if not qualified
+ *
+ * @example
+ * getPackageFromQualifiedName('@happyvertical/smrt-core:Product')
+ * // Returns: '@happyvertical/smrt-core'
+ *
+ * getPackageFromQualifiedName('Product')
+ * // Returns: undefined
+ */
+export declare function getPackageFromQualifiedName(name: string): string | undefined;
+/**
+ * Compares two qualified names for equality.
+ * Case-sensitive comparison.
+ *
+ * @param a - First qualified name
+ * @param b - Second qualified name
+ * @returns true if the qualified names are equal
+ */
+export declare function qualifiedNamesEqual(a: string, b: string): boolean;
+/**
+ * Checks if a qualified name belongs to a specific package.
+ *
+ * @param qualifiedName - The qualified name to check
+ * @param packageName - The package name to match against
+ * @returns true if the qualified name is from the specified package
+ *
+ * @example
+ * isFromPackage('@happyvertical/smrt-core:Product', '@happyvertical/smrt-core')
+ * // Returns: true
+ */
+export declare function isFromPackage(qualifiedName: string, packageName: string): boolean;
+/**
+ * Checks if a qualified name (like `_meta_type`) matches a short class name.
+ * This is useful for STI filtering where the database stores qualified names
+ * but code often uses short names for comparisons.
+ *
+ * @param qualifiedName - The qualified name or simple name to check (e.g., from `_meta_type`)
+ * @param shortName - The short class name to match against
+ * @returns true if the class name portion matches
+ *
+ * @example
+ * ```typescript
+ * // Filtering STI records by type
+ * const meetings = events.filter(e => isType(e._meta_type, 'Meeting'));
+ *
+ * // Works with both qualified and simple names
+ * isType('@happyvertical/praeco:MeetingRecap', 'MeetingRecap') // true
+ * isType('@happyvertical/praeco:MeetingRecap', 'Article') // false
+ * isType('MeetingRecap', 'MeetingRecap') // true (simple name passthrough)
+ * ```
+ */
+export declare function isType(qualifiedName: string | null | undefined, shortName: string): boolean;
+//# sourceMappingURL=qualified-names.d.ts.map

package/dist/utils/qualified-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualified-names.d.ts","sourceRoot":"","sources":["../../src/utils/qualified-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,kBAAkB,CAcpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,mBAAmB,CAgB7E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,kBAAkB,CAyBxE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK5E;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAMT;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CACpB,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACxC,SAAS,EAAE,MAAM,GAChB,OAAO,CAKT"}

package/dist/utils/qualified-names.js

@@ -0,0 +1,82 @@
+function createQualifiedName(packageName, className) {
+  if (!packageName) {
+    throw new Error(
+      `Cannot create qualified name: packageName is required. Got className="${className}" but no packageName.`
+    );
+  }
+  if (!className) {
+    throw new Error(
+      `Cannot create qualified name: className is required. Got packageName="${packageName}" but no className.`
+    );
+  }
+  return `${packageName}:${className}`;
+}
+function parseQualifiedName(qualifiedName) {
+  if (!isQualifiedName(qualifiedName)) {
+    throw new Error(
+      `Invalid qualified name: "${qualifiedName}". Expected format: "@package/name:ClassName"`
+    );
+  }
+  const colonIndex = qualifiedName.lastIndexOf(":");
+  return {
+    packageName: qualifiedName.slice(0, colonIndex),
+    className: qualifiedName.slice(colonIndex + 1)
+  };
+}
+function isQualifiedName(name) {
+  if (!name || typeof name !== "string") {
+    return false;
+  }
+  const colonIndex = name.lastIndexOf(":");
+  if (colonIndex === -1) {
+    return false;
+  }
+  const packageName = name.slice(0, colonIndex);
+  const className = name.slice(colonIndex + 1);
+  if (!packageName.startsWith("@") || !packageName.includes("/")) {
+    return false;
+  }
+  if (!className) {
+    return false;
+  }
+  return true;
+}
+function getClassName(name) {
+  if (isQualifiedName(name)) {
+    return parseQualifiedName(name).className;
+  }
+  return name;
+}
+function getPackageFromQualifiedName(name) {
+  if (isQualifiedName(name)) {
+    return parseQualifiedName(name).packageName;
+  }
+  return void 0;
+}
+function qualifiedNamesEqual(a, b) {
+  return a === b;
+}
+function isFromPackage(qualifiedName, packageName) {
+  if (!isQualifiedName(qualifiedName)) {
+    return false;
+  }
+  const parsed = parseQualifiedName(qualifiedName);
+  return parsed.packageName === packageName;
+}
+function isType(qualifiedName, shortName) {
+  if (!qualifiedName) {
+    return false;
+  }
+  return getClassName(qualifiedName) === shortName;
+}
+export {
+  createQualifiedName,
+  getClassName,
+  getPackageFromQualifiedName,
+  isFromPackage,
+  isQualifiedName,
+  isType,
+  parseQualifiedName,
+  qualifiedNamesEqual
+};
+//# sourceMappingURL=qualified-names.js.map

package/dist/utils/qualified-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualified-names.js","sources":["../../src/utils/qualified-names.ts"],"sourcesContent":["/**\n * Utilities for working with qualified class names in the SMRT framework.\n *\n * Qualified names follow the format: \"@package/name:ClassName\"\n * Example: \"@happyvertical/smrt-core:Product\"\n *\n * This format uniquely identifies classes across packages, eliminating\n * name collisions when multiple packages define classes with the same name.\n */\n\nimport type { QualifiedClassName } from '../scanner/types.js';\n\n/**\n * Creates a qualified class name from package name and class name.\n *\n * @param packageName - The npm package name (e.g., \"@happyvertical/smrt-core\")\n * @param className - The class name (e.g., \"Product\")\n * @returns Qualified name in format \"@package/name:ClassName\"\n *\n * @example\n * createQualifiedName('@happyvertical/smrt-core', 'Product')\n * // Returns: \"@happyvertical/smrt-core:Product\"\n */\nexport function createQualifiedName(\n  packageName: string,\n  className: string,\n): QualifiedClassName {\n  if (!packageName) {\n    throw new Error(\n      `Cannot create qualified name: packageName is required. ` +\n        `Got className=\"${className}\" but no packageName.`,\n    );\n  }\n  if (!className) {\n    throw new Error(\n      `Cannot create qualified name: className is required. ` +\n        `Got packageName=\"${packageName}\" but no className.`,\n    );\n  }\n  return `${packageName}:${className}` as QualifiedClassName;\n}\n\n/**\n * Result of parsing a qualified class name.\n */\nexport interface ParsedQualifiedName {\n  /** The package name (e.g., \"@happyvertical/smrt-core\") */\n  packageName: string;\n  /** The class name (e.g., \"Product\") */\n  className: string;\n}\n\n/**\n * Parses a qualified class name into its components.\n *\n * @param qualifiedName - The qualified name to parse\n * @returns Object with packageName and className\n * @throws Error if the name is not a valid qualified name\n *\n * @example\n * parseQualifiedName('@happyvertical/smrt-core:Product')\n * // Returns: { packageName: '@happyvertical/smrt-core', className: 'Product' }\n */\nexport function parseQualifiedName(qualifiedName: string): ParsedQualifiedName {\n  if (!isQualifiedName(qualifiedName)) {\n    throw new Error(\n      `Invalid qualified name: \"${qualifiedName}\". ` +\n        `Expected format: \"@package/name:ClassName\"`,\n    );\n  }\n\n  // Use lastIndexOf to handle edge cases like \"@scope/pkg:Nested:Class\"\n  // (though class names shouldn't have colons, this is defensive)\n  const colonIndex = qualifiedName.lastIndexOf(':');\n\n  return {\n    packageName: qualifiedName.slice(0, colonIndex),\n    className: qualifiedName.slice(colonIndex + 1),\n  };\n}\n\n/**\n * Checks if a name is a valid qualified class name.\n *\n * A valid qualified name:\n * - Contains a colon (:) separating package and class\n * - Has a package name with a forward slash (scoped npm package)\n * - Has a non-empty class name after the colon\n *\n * @param name - The name to check\n * @returns true if the name is a valid qualified class name\n *\n * @example\n * isQualifiedName('@happyvertical/smrt-core:Product') // true\n * isQualifiedName('Product') // false\n * isQualifiedName('smrt-core:Product') // false (no @ scope)\n */\nexport function isQualifiedName(name: string): name is QualifiedClassName {\n  if (!name || typeof name !== 'string') {\n    return false;\n  }\n\n  const colonIndex = name.lastIndexOf(':');\n  if (colonIndex === -1) {\n    return false;\n  }\n\n  const packageName = name.slice(0, colonIndex);\n  const className = name.slice(colonIndex + 1);\n\n  // Package name must be a scoped npm package (contains @)\n  // and have a path (contains /)\n  if (!packageName.startsWith('@') || !packageName.includes('/')) {\n    return false;\n  }\n\n  // Class name must be non-empty\n  if (!className) {\n    return false;\n  }\n\n  return true;\n}\n\n/**\n * Extracts just the class name from a qualified name or simple name.\n * Useful when you need the class name regardless of whether\n * the input is qualified or not.\n *\n * @param name - Qualified name or simple class name\n * @returns The simple class name\n *\n * @example\n * getClassName('@happyvertical/smrt-core:Product') // 'Product'\n * getClassName('Product') // 'Product'\n */\nexport function getClassName(name: string): string {\n  if (isQualifiedName(name)) {\n    return parseQualifiedName(name).className;\n  }\n  return name;\n}\n\n/**\n * Extracts the package name from a qualified name.\n * Returns undefined if the name is not qualified.\n *\n * @param name - Qualified name or simple class name\n * @returns The package name, or undefined if not qualified\n *\n * @example\n * getPackageFromQualifiedName('@happyvertical/smrt-core:Product')\n * // Returns: '@happyvertical/smrt-core'\n *\n * getPackageFromQualifiedName('Product')\n * // Returns: undefined\n */\nexport function getPackageFromQualifiedName(name: string): string | undefined {\n  if (isQualifiedName(name)) {\n    return parseQualifiedName(name).packageName;\n  }\n  return undefined;\n}\n\n/**\n * Compares two qualified names for equality.\n * Case-sensitive comparison.\n *\n * @param a - First qualified name\n * @param b - Second qualified name\n * @returns true if the qualified names are equal\n */\nexport function qualifiedNamesEqual(a: string, b: string): boolean {\n  return a === b;\n}\n\n/**\n * Checks if a qualified name belongs to a specific package.\n *\n * @param qualifiedName - The qualified name to check\n * @param packageName - The package name to match against\n * @returns true if the qualified name is from the specified package\n *\n * @example\n * isFromPackage('@happyvertical/smrt-core:Product', '@happyvertical/smrt-core')\n * // Returns: true\n */\nexport function isFromPackage(\n  qualifiedName: string,\n  packageName: string,\n): boolean {\n  if (!isQualifiedName(qualifiedName)) {\n    return false;\n  }\n  const parsed = parseQualifiedName(qualifiedName);\n  return parsed.packageName === packageName;\n}\n\n/**\n * Checks if a qualified name (like `_meta_type`) matches a short class name.\n * This is useful for STI filtering where the database stores qualified names\n * but code often uses short names for comparisons.\n *\n * @param qualifiedName - The qualified name or simple name to check (e.g., from `_meta_type`)\n * @param shortName - The short class name to match against\n * @returns true if the class name portion matches\n *\n * @example\n * ```typescript\n * // Filtering STI records by type\n * const meetings = events.filter(e => isType(e._meta_type, 'Meeting'));\n *\n * // Works with both qualified and simple names\n * isType('@happyvertical/praeco:MeetingRecap', 'MeetingRecap') // true\n * isType('@happyvertical/praeco:MeetingRecap', 'Article') // false\n * isType('MeetingRecap', 'MeetingRecap') // true (simple name passthrough)\n * ```\n */\nexport function isType(\n  qualifiedName: string | null | undefined,\n  shortName: string,\n): boolean {\n  if (!qualifiedName) {\n    return false;\n  }\n  return getClassName(qualifiedName) === shortName;\n}\n"],"names":[],"mappings":"AAuBO,SAAS,oBACd,aACA,WACoB;AACpB,MAAI,CAAC,aAAa;AAChB,UAAM,IAAI;AAAA,MACR,yEACoB,SAAS;AAAA,IAAA;AAAA,EAEjC;AACA,MAAI,CAAC,WAAW;AACd,UAAM,IAAI;AAAA,MACR,yEACsB,WAAW;AAAA,IAAA;AAAA,EAErC;AACA,SAAO,GAAG,WAAW,IAAI,SAAS;AACpC;AAuBO,SAAS,mBAAmB,eAA4C;AAC7E,MAAI,CAAC,gBAAgB,aAAa,GAAG;AACnC,UAAM,IAAI;AAAA,MACR,4BAA4B,aAAa;AAAA,IAAA;AAAA,EAG7C;AAIA,QAAM,aAAa,cAAc,YAAY,GAAG;AAEhD,SAAO;AAAA,IACL,aAAa,cAAc,MAAM,GAAG,UAAU;AAAA,IAC9C,WAAW,cAAc,MAAM,aAAa,CAAC;AAAA,EAAA;AAEjD;AAkBO,SAAS,gBAAgB,MAA0C;AACxE,MAAI,CAAC,QAAQ,OAAO,SAAS,UAAU;AACrC,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,KAAK,YAAY,GAAG;AACvC,MAAI,eAAe,IAAI;AACrB,WAAO;AAAA,EACT;AAEA,QAAM,cAAc,KAAK,MAAM,GAAG,UAAU;AAC5C,QAAM,YAAY,KAAK,MAAM,aAAa,CAAC;AAI3C,MAAI,CAAC,YAAY,WAAW,GAAG,KAAK,CAAC,YAAY,SAAS,GAAG,GAAG;AAC9D,WAAO;AAAA,EACT;AAGA,MAAI,CAAC,WAAW;AACd,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAcO,SAAS,aAAa,MAAsB;AACjD,MAAI,gBAAgB,IAAI,GAAG;AACzB,WAAO,mBAAmB,IAAI,EAAE;AAAA,EAClC;AACA,SAAO;AACT;AAgBO,SAAS,4BAA4B,MAAkC;AAC5E,MAAI,gBAAgB,IAAI,GAAG;AACzB,WAAO,mBAAmB,IAAI,EAAE;AAAA,EAClC;AACA,SAAO;AACT;AAUO,SAAS,oBAAoB,GAAW,GAAoB;AACjE,SAAO,MAAM;AACf;AAaO,SAAS,cACd,eACA,aACS;AACT,MAAI,CAAC,gBAAgB,aAAa,GAAG;AACnC,WAAO;AAAA,EACT;AACA,QAAM,SAAS,mBAAmB,aAAa;AAC/C,SAAO,OAAO,gBAAgB;AAChC;AAsBO,SAAS,OACd,eACA,WACS;AACT,MAAI,CAAC,eAAe;AAClB,WAAO;AAAA,EACT;AACA,SAAO,aAAa,aAAa,MAAM;AACzC;"}

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

@@ -0,0 +1,37 @@
+import { SmartObjectManifest } from '../scanner/types.js';
+export interface OxcScannerLike {
+    scanAndResolve(): Promise<{
+        results: {
+            typeAliases: Record<string, string>;
+            errors: Array<{
+                filePath: string;
+                message: string;
+                line?: number;
+            }>;
+        };
+        resolved: unknown[];
+    }>;
+}
+export interface OxcScannerConstructor {
+    new (options: {
+        cwd: string;
+        include?: string[];
+        exclude?: string[];
+        baseClasses?: string[];
+        includePrivateMethods?: boolean;
+        includeStaticMethods?: boolean;
+        followImports?: boolean;
+    }): OxcScannerLike;
+}
+export interface ManifestAdapterLike {
+    toManifest(resolved: unknown[], options: {
+        packageName?: string;
+        packageVersion?: string;
+        typeAliases: Record<string, string>;
+    }): SmartObjectManifest;
+}
+export interface ScannerModule {
+    OxcScanner: OxcScannerConstructor;
+    ManifestAdapter: new () => ManifestAdapterLike;
+}
+//# sourceMappingURL=scanner-module.d.ts.map

package/dist/utils/scanner-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner-module.d.ts","sourceRoot":"","sources":["../../src/utils/scanner-module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,cAAc,IAAI,OAAO,CAAC;QACxB,OAAO,EAAE;YACP,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACpC,MAAM,EAAE,KAAK,CAAC;gBACZ,QAAQ,EAAE,MAAM,CAAC;gBACjB,OAAO,EAAE,MAAM,CAAC;gBAChB,IAAI,CAAC,EAAE,MAAM,CAAC;aACf,CAAC,CAAC;SACJ,CAAC;QACF,QAAQ,EAAE,OAAO,EAAE,CAAC;KACrB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,OAAO,EAAE;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,GAAG,cAAc,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,CACR,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACrC,GACA,mBAAmB,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,qBAAqB,CAAC;IAClC,eAAe,EAAE,UAAU,mBAAmB,CAAC;CAChD"}