@stackql/provider-utils 0.3.5 → 0.3.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackql/provider-utils",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "Utilities for building StackQL providers from OpenAPI specifications.",
   "type": "module",
   "main": "./src/index.js",

package/src/providerdev/split.js

@@ -153,6 +153,38 @@ function getAllRefs(obj) {
   return refs;
 }
 
+/**
+ * Extract all $ref values from path-level parameters
+ * @param {Object} pathItem - Path item from OpenAPI doc
+ * @returns {Set<string>} - Set of refs
+ */
+function getPathLevelRefs(pathItem) {
+  const refs = new Set();
+  
+  // Check for path-level parameters
+  if (pathItem.parameters) {
+    for (const param of pathItem.parameters) {
+      if (param.$ref) {
+        refs.add(param.$ref);
+        if (param.$ref.includes('/parameters/')) {
+          // Make sure we catch all parameters, especially path parameters
+          const paramName = param.$ref.split('/').pop();
+          if (paramName) {
+            refs.add(`#/components/parameters/${paramName}`);
+          }
+        }
+      } else if (typeof param === 'object') {
+        // Extract refs from schema if present
+        for (const ref of getAllRefs(param)) {
+          refs.add(ref);
+        }
+      }
+    }
+  }
+  
+  return refs;
+}
+
 /**
  * Add referenced components to service
  * @param {Set<string>} refs - Set of refs
@@ -240,7 +272,7 @@ export async function split(options) {
     logger.level = 'debug';
   }
   
-  logger.info(`📄 Splitting OpenAPI doc for ${providerName}`);
+  logger.info(`🔄 Splitting OpenAPI doc for ${providerName}`);
   logger.info(`API Doc: ${apiDoc}`);
   logger.info(`Output: ${outputDir}`);
   logger.info(`Service Discriminator: ${svcDiscriminator}`);
@@ -393,6 +425,26 @@ export async function split(options) {
         }
       }
     }
+    
+    // After processing all operations in the path, collect path-level refs
+    const pathRefs = getPathLevelRefs(pathItem);
+    
+    // Add path-level refs to all services that use this path
+    for (const svcName in services) {
+      if (services[svcName].paths[pathKey]) {
+        if (verbose) {
+          logger.debug(`Adding path-level refs for ${pathKey} to service ${svcName}`);
+        }
+        
+        // Copy path-level parameters if they exist
+        if (pathItem.parameters) {
+          services[svcName].paths[pathKey].parameters = pathItem.parameters;
+        }
+        
+        // Add references from path-level parameters
+        addRefsToComponents(pathRefs, services[svcName], apiDocObj.components || {}, verbose);
+      }
+    }
   }
   
   // Add non-operations to each service
@@ -476,10 +528,7 @@ export async function split(options) {
   for (const service in services) {
     logger.info(`✅ Writing out OpenAPI doc for [${service}]`);
 
-    // const svcDir = path.join(outputDir, service);
-    // const outputFile = path.join(svcDir, `${service}.yaml`);
     const outputFile = path.join(outputDir, `${service}.yaml`);    
-    // fs.mkdirSync(svcDir, { recursive: true });
     
     fs.writeFileSync(outputFile, yaml.dump(services[service], { 
       noRefs: true,
@@ -489,4 +538,4 @@ export async function split(options) {
   
   logger.info(`🎉 Successfully split OpenAPI doc into ${Object.keys(services).length} services`);
   return true;
-}
+}