@alizarin/napi 2.0.0-alpha.93 → 2.0.0-alpha.94

package/index.d.ts

@@ -44,6 +44,24 @@ export declare function getRegisteredExtensionHandlers(): Array<string>
 export declare function parseSkosXml(xmlContent: string, baseUri: string): any
 /** Parse SKOS RDF/XML and return a single collection (the first one found). */
 export declare function parseSkosXmlToCollection(xmlContent: string, baseUri: string): any
+/**
+ * Build a mapping from node alias to collection ID based on graph definition.
+ *
+ * Equivalent to WASM's `buildAliasToCollectionMap`.
+ */
+export declare function buildAliasToCollectionMap(graphJson: string, resolvableDatatypes?: Array<string> | undefined | null, configKeys?: Array<string> | undefined | null): Record<string, string>
+/**
+ * Scan a JSON tree to find which collections are needed for resolution.
+ *
+ * Equivalent to WASM's `findNeededCollections`.
+ */
+export declare function findNeededCollections(treeJson: string, aliasToCollection: Record<string, string>): Array<string>
+/** Check if a string is a valid UUID. */
+export declare function isValidUuid(s: string): boolean
+/** Get the default resolvable datatypes (concept, concept-list). */
+export declare function getDefaultResolvableDatatypes(): Array<string>
+/** Get the default config keys for collection IDs. */
+export declare function getDefaultConfigKeys(): Array<string>
 /**
  * Import a prebuild/pkg directory: register graphs, load SKOS collections,
  * and load ontology configs.
@@ -62,6 +80,18 @@ export declare class NapiRdmCache {
   /** Load a single collection from JSON. */
   loadCollectionJson(jsonStr: string): void
   get collectionCount(): number
+  /** Check if a collection is already in the cache. */
+  hasCollection(collectionId: string): boolean
+  /** Add a collection from a JSON string of concepts. */
+  addCollectionFromJson(collectionId: string, jsonStr: string): void
+  /** Get the parent concept ID for a concept within a collection. */
+  getParentId(collectionId: string, conceptId: string): string | null
+  /** Remove a collection from the cache. */
+  removeCollection(collectionId: string): boolean
+  /** Clear all collections from the cache. */
+  clear(): void
+  /** Resolve labels to UUIDs using this cache for lookups. */
+  resolveLabels(treeJson: string, aliasToCollection: Record<string, string>, strict: boolean): any
 }
 export declare class NapiNodeConfigManager {
   constructor()
@@ -211,6 +241,13 @@ export declare class NapiResourceInstanceWrapper {
   ensureNodegroup(allValuesJs: any, allNodegroupsJs: any, nodegroupId: string, addIfMissing: boolean, nodegroupPermissionsJs: any, doImpliedNodegroups: boolean): NapiEnsureNodegroupResult
   /** Build pseudo values from tiles for a specific nodegroup. */
   valuesFromResourceNodegroup(existingValuesJs: any, nodegroupTileIds: Array<string>, nodegroupId: string): NapiValuesFromNodegroupResult
+  /**
+   * Resolve a dot-separated path to its target node metadata without needing tiles.
+   *
+   * Returns { nodegroupId, isSingle, targetNodeId } — enough for the JS layer to
+   * lazy-load just that nodegroup's tiles before calling getValuesAtPath.
+   */
+  resolvePath(path: string): any
   /** Resolve a dot-separated path and return a PseudoList. */
   getValuesAtPath(path: string): NapiPseudoList
   /**

package/index.js

@@ -310,7 +310,7 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { NapiRdmCache, NapiNodeConfigManager, NapiTileData, NapiStaticTile, NapiPseudoValue, NapiPseudoList, NapiPopulateResult, NapiEnsureNodegroupResult, NapiValuesFromNodegroupResult, NapiResourceInstanceWrapper, NapiResourceModelWrapper, NapiPrebuildExporter, NapiStaticGraph, NapiStaticResourceRegistry, buildGraphFromCsvs, buildBusinessDataFromCsv, extensionCoerce, extensionRenderDisplay, extensionResolveMarkers, hasExtensionHandler, getRegisteredExtensionHandlers, parseSkosXml, parseSkosXmlToCollection, importPrebuild } = nativeBinding
+const { NapiRdmCache, NapiNodeConfigManager, NapiTileData, NapiStaticTile, NapiPseudoValue, NapiPseudoList, NapiPopulateResult, NapiEnsureNodegroupResult, NapiValuesFromNodegroupResult, NapiResourceInstanceWrapper, NapiResourceModelWrapper, NapiPrebuildExporter, NapiStaticGraph, NapiStaticResourceRegistry, buildGraphFromCsvs, buildBusinessDataFromCsv, extensionCoerce, extensionRenderDisplay, extensionResolveMarkers, hasExtensionHandler, getRegisteredExtensionHandlers, parseSkosXml, parseSkosXmlToCollection, buildAliasToCollectionMap, findNeededCollections, isValidUuid, getDefaultResolvableDatatypes, getDefaultConfigKeys, importPrebuild } = nativeBinding
 
 module.exports.NapiRdmCache = NapiRdmCache
 module.exports.NapiNodeConfigManager = NapiNodeConfigManager
@@ -335,4 +335,9 @@ module.exports.hasExtensionHandler = hasExtensionHandler
 module.exports.getRegisteredExtensionHandlers = getRegisteredExtensionHandlers
 module.exports.parseSkosXml = parseSkosXml
 module.exports.parseSkosXmlToCollection = parseSkosXmlToCollection
+module.exports.buildAliasToCollectionMap = buildAliasToCollectionMap
+module.exports.findNeededCollections = findNeededCollections
+module.exports.isValidUuid = isValidUuid
+module.exports.getDefaultResolvableDatatypes = getDefaultResolvableDatatypes
+module.exports.getDefaultConfigKeys = getDefaultConfigKeys
 module.exports.importPrebuild = importPrebuild

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alizarin/napi",
-  "version": "2.0.0-alpha.93",
+  "version": "2.0.0-alpha.94",
   "license": "AGPL-3.0-or-later",
   "repository": {
     "type": "git",
@@ -30,8 +30,8 @@
     "@napi-rs/cli": "^2.18.0"
   },
   "optionalDependencies": {
-    "@alizarin/napi-win32-x64-msvc": "2.0.0-alpha.93",
-    "@alizarin/napi-darwin-x64": "2.0.0-alpha.93",
-    "@alizarin/napi-linux-x64-gnu": "2.0.0-alpha.93"
+    "@alizarin/napi-win32-x64-msvc": "2.0.0-alpha.94",
+    "@alizarin/napi-darwin-x64": "2.0.0-alpha.94",
+    "@alizarin/napi-linux-x64-gnu": "2.0.0-alpha.94"
   }
 }

package/src/instance_wrapper_napi.rs

@@ -82,6 +82,64 @@ impl NapiRdmCache {
     pub fn collection_count(&self) -> u32 {
         self.inner.len() as u32
     }
+
+    /// Check if a collection is already in the cache.
+    #[napi]
+    pub fn has_collection(&self, collection_id: String) -> bool {
+        self.inner.has_collection(&collection_id)
+    }
+
+    /// Add a collection from a JSON string of concepts.
+    #[napi]
+    pub fn add_collection_from_json(
+        &mut self,
+        collection_id: String,
+        json_str: String,
+    ) -> Result<()> {
+        self.inner
+            .add_collection_from_json(&collection_id, &json_str)
+            .map_err(|e| napi::Error::from_reason(format!("Failed to add collection: {e}")))
+    }
+
+    /// Get the parent concept ID for a concept within a collection.
+    #[napi]
+    pub fn get_parent_id(&self, collection_id: String, concept_id: String) -> Option<String> {
+        self.inner.get_parent_id(&collection_id, &concept_id)
+    }
+
+    /// Remove a collection from the cache.
+    #[napi]
+    pub fn remove_collection(&mut self, collection_id: String) -> bool {
+        self.inner.remove_collection(&collection_id)
+    }
+
+    /// Clear all collections from the cache.
+    #[napi]
+    pub fn clear(&mut self) {
+        self.inner.clear();
+    }
+
+    /// Resolve labels to UUIDs using this cache for lookups.
+    #[napi]
+    pub fn resolve_labels(
+        &self,
+        tree_json: String,
+        alias_to_collection: HashMap<String, String>,
+        strict: bool,
+    ) -> Result<serde_json::Value> {
+        let tree: serde_json::Value = serde_json::from_str(&tree_json)
+            .map_err(|e| napi::Error::from_reason(format!("Invalid tree JSON: {e}")))?;
+
+        let resolved = alizarin_core::label_resolution::resolve_labels(
+            tree,
+            &alias_to_collection,
+            &self.inner,
+            strict,
+        )
+        .map_err(|e| napi::Error::from_reason(e.message))?;
+
+        Ok(resolved)
+    }
 }
 
 // =============================================================================
@@ -1128,6 +1186,23 @@ impl NapiResourceInstanceWrapper {
     // Path resolution
     // =========================================================================
 
+    /// Resolve a dot-separated path to its target node metadata without needing tiles.
+    ///
+    /// Returns { nodegroupId, isSingle, targetNodeId } — enough for the JS layer to
+    /// lazy-load just that nodegroup's tiles before calling getValuesAtPath.
+    #[napi(js_name = "resolvePath")]
+    pub fn resolve_path(&self, path: String) -> Result<serde_json::Value> {
+        let info = self
+            .inner
+            .resolve_path(&path, &self.model_access)
+            .map_err(|e| napi::Error::from_reason(e.to_string()))?;
+        Ok(serde_json::json!({
+            "nodegroupId": info.nodegroup_id,
+            "isSingle": info.is_single,
+            "targetNodeId": info.target_node.nodeid,
+        }))
+    }
+
     /// Resolve a dot-separated path and return a PseudoList.
     #[napi]
     pub fn get_values_at_path(&self, path: String) -> Result<NapiPseudoList> {

package/src/lib.rs

@@ -558,6 +558,82 @@ pub fn parse_skos_xml_to_collection(
     serde_json::to_value(&collection).map_err(|e| napi::Error::from_reason(e.to_string()))
 }
 
+// ============================================================================
+// Label resolution utilities
+// ============================================================================
+
+/// Build a mapping from node alias to collection ID based on graph definition.
+///
+/// Equivalent to WASM's `buildAliasToCollectionMap`.
+#[napi(js_name = "buildAliasToCollectionMap")]
+pub fn build_alias_to_collection_map(
+    graph_json: String,
+    resolvable_datatypes: Option<Vec<String>>,
+    config_keys: Option<Vec<String>>,
+) -> Result<HashMap<String, String>> {
+    let graph: serde_json::Value = serde_json::from_str(&graph_json)
+        .map_err(|e| napi::Error::from_reason(format!("Invalid graph JSON: {e}")))?;
+
+    let config = alizarin_core::LabelResolutionConfig {
+        resolvable_datatypes: resolvable_datatypes.unwrap_or_else(|| {
+            alizarin_core::DEFAULT_RESOLVABLE_DATATYPES
+                .iter()
+                .map(|s| s.to_string())
+                .collect()
+        }),
+        config_keys: config_keys.unwrap_or_else(|| {
+            alizarin_core::DEFAULT_CONFIG_KEYS
+                .iter()
+                .map(|s| s.to_string())
+                .collect()
+        }),
+        strict: false,
+    };
+
+    Ok(alizarin_core::build_alias_to_collection_map(
+        &graph, &config,
+    ))
+}
+
+/// Scan a JSON tree to find which collections are needed for resolution.
+///
+/// Equivalent to WASM's `findNeededCollections`.
+#[napi(js_name = "findNeededCollections")]
+pub fn find_needed_collections(
+    tree_json: String,
+    alias_to_collection: HashMap<String, String>,
+) -> Result<Vec<String>> {
+    let tree: serde_json::Value = serde_json::from_str(&tree_json)
+        .map_err(|e| napi::Error::from_reason(format!("Invalid tree JSON: {e}")))?;
+
+    let needed = alizarin_core::find_needed_collections(&tree, &alias_to_collection);
+    Ok(needed.into_iter().collect())
+}
+
+/// Check if a string is a valid UUID.
+#[napi(js_name = "isValidUuid")]
+pub fn is_valid_uuid(s: String) -> bool {
+    alizarin_core::is_valid_uuid(&s)
+}
+
+/// Get the default resolvable datatypes (concept, concept-list).
+#[napi(js_name = "getDefaultResolvableDatatypes")]
+pub fn get_default_resolvable_datatypes() -> Vec<String> {
+    alizarin_core::DEFAULT_RESOLVABLE_DATATYPES
+        .iter()
+        .map(|s| s.to_string())
+        .collect()
+}
+
+/// Get the default config keys for collection IDs.
+#[napi(js_name = "getDefaultConfigKeys")]
+pub fn get_default_config_keys() -> Vec<String> {
+    alizarin_core::DEFAULT_CONFIG_KEYS
+        .iter()
+        .map(|s| s.to_string())
+        .collect()
+}
+
 // ============================================================================
 // Prebuild import (high-level convenience)
 // ============================================================================