@stackql/provider-utils 0.3.4 → 0.3.6

package/package.json

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

package/src/providerdev/generate.js

@@ -158,6 +158,15 @@ export async function generate(options) {
     const files = fs.readdirSync(inputDir);
     
     for (const filename of files) {
+
+      const filePath = path.join(inputDir, filename);
+      
+      // Skip directories
+      if (fs.statSync(filePath).isDirectory()) {
+        logger.info(`📁 Skipping directory: ${filename}`);
+        continue;
+      }
+  
       if (skipFiles.includes(filename)) {
         logger.info(`⭐️ Skipping ${filename} (matched --skip)`);
         continue;

package/src/providerdev/split.js

@@ -153,6 +153,40 @@ 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);
+      } else if (typeof param === 'object') {
+        // Extract refs from schema if present
+        for (const ref of getAllRefs(param)) {
+          refs.add(ref);
+        }
+      }
+    }
+  }
+  
+  // Check other non-operation fields
+  for (const [key, value] of Object.entries(pathItem)) {
+    if (!OPERATIONS.includes(key) && typeof value === 'object') {
+      for (const ref of getAllRefs(value)) {
+        refs.add(ref);
+      }
+    }
+  }
+  
+  return refs;
+}
+
 /**
  * Add referenced components to service
  * @param {Set<string>} refs - Set of refs
@@ -240,7 +274,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 +427,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 +530,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 +540,4 @@ export async function split(options) {
   
   logger.info(`🎉 Successfully split OpenAPI doc into ${Object.keys(services).length} services`);
   return true;
-}
+}