@stackql/provider-utils 0.5.6 → 0.5.8

package/package.json

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

package/src/docgen/generator.js

@@ -291,6 +291,7 @@ export async function generateDocsv2(options) {
         outputDir,          // e.g., 'website'
         providerDataDir,    // e.g., 'config/provider-data'
         dereferenced = false,
+        succinct = false,   // use summary instead of description for method/example descriptions
     } = options;
 
     console.log(`documenting ${providerName} (v2)...`);
@@ -338,7 +339,7 @@ export async function generateDocsv2(options) {
         const filePath = path.join(serviceDir, file);
         totalServicesCount++;
         const serviceFolder = `${servicesDir}/${serviceName}`;
-        await createDocsForServicev2(filePath, providerName, serviceName, serviceFolder, dereferenced);
+        await createDocsForServicev2(filePath, providerName, serviceName, serviceFolder, dereferenced, succinct);
     }
 
     console.log(`Processed ${totalServicesCount} services`);
@@ -394,7 +395,7 @@ ${servicesToMarkdown(providerName, secondColumnServices)}
 }
 
 // v2 service processing - uses SchemaTable for collapsible nested fields
-async function createDocsForServicev2(yamlFilePath, providerName, serviceName, serviceFolder, dereferenced = false) {
+async function createDocsForServicev2(yamlFilePath, providerName, serviceName, serviceFolder, dereferenced = false, succinct = false) {
 
     const data = yaml.load(fs.readFileSync(yamlFilePath, 'utf8'));
 
@@ -467,18 +468,18 @@ async function createDocsForServicev2(yamlFilePath, providerName, serviceName, s
 
     // Process each resource in first column
     for (const resource of firstColumn) {
-        await processResourcev2(providerName, serviceFolder, serviceName, resource);
+        await processResourcev2(providerName, serviceFolder, serviceName, resource, succinct);
     }
 
     // Process each resource in second column
     for (const resource of secondColumn) {
-        await processResourcev2(providerName, serviceFolder, serviceName, resource);
+        await processResourcev2(providerName, serviceFolder, serviceName, resource, succinct);
     }
 
     console.log(`Generated documentation (v2) for ${serviceName}`);
 }
 
-async function processResourcev2(providerName, serviceFolder, serviceName, resource) {
+async function processResourcev2(providerName, serviceFolder, serviceName, resource, succinct = false) {
     console.log(`Processing resource (v2): ${resource.name}`);
 
     const resourceFolder = path.join(serviceFolder, resource.name);
@@ -491,6 +492,7 @@ async function processResourcev2(providerName, serviceFolder, serviceName, resou
         providerName,
         serviceName,
         resource,
+        succinct,
     );
     fs.writeFileSync(resourceIndexPath, resourceIndexContent);
 

package/src/docgen/helpers.js

@@ -134,7 +134,7 @@ export function getSqlMethodsWithOrderedFields(resourceData, dereferencedAPI, sq
                 }
 
                 // Get response and params using the same function as for SQL verbs
-                const { respProps, respDescription, opDescription, requestBody } = getHttpOperationInfo(
+                const { respProps, respDescription, opDescription, opSummary, requestBody } = getHttpOperationInfo(
                     dereferencedAPI,
                     resolvedPath,
                     resolvedVerb,
@@ -152,12 +152,14 @@ export function getSqlMethodsWithOrderedFields(resourceData, dereferencedAPI, sq
                 // Initialize the method with the same structure as SQL methods
                 methods[methodName] = {
                     opDescription,
+                    opSummary,
                     respDescription,
                     properties: {},
                     requiredParams: requiredParams || {},
                     optionalParams: optionalParams || {},
                     requestBody: requestBody || {},
                     rawRespProps: respProps,
+                    methodConfig: methodData.config || null,
                 };
 
                 // Format and sort the properties using our helper functions
@@ -176,19 +178,21 @@ export function getSqlMethodsWithOrderedFields(resourceData, dereferencedAPI, sq
     }
 
     for (const thisMethod of resourceData.sqlVerbs[sqlVerb]) {
-        const {path, httpVerb, mediaType, openAPIDocKey, objectKey, methodName} = getHttpOperationForSqlVerb(thisMethod.$ref, resourceData);
-        const {respProps, respDescription, opDescription, requestBody} = getHttpOperationInfo(dereferencedAPI, path, httpVerb, mediaType, openAPIDocKey, objectKey);
+        const {path, httpVerb, mediaType, openAPIDocKey, objectKey, methodName, methodConfig} = getHttpOperationForSqlVerb(thisMethod.$ref, resourceData);
+        const {respProps, respDescription, opDescription, opSummary, requestBody} = getHttpOperationInfo(dereferencedAPI, path, httpVerb, mediaType, openAPIDocKey, objectKey);
         const {requiredParams, optionalParams} = getHttpOperationParams(dereferencedAPI, path, httpVerb);
 
         // Initialize the method object with description and params
         methods[methodName] = {
             opDescription,
+            opSummary,
             respDescription,
             properties: {},
             requiredParams: requiredParams || {},
             optionalParams: optionalParams || {},
             requestBody: requestBody || {},
             rawRespProps: respProps,
+            methodConfig: methodConfig || null,
         };
 
         // Format and sort the properties using our helper functions
@@ -253,12 +257,19 @@ function formatProperties(respProps) {
         // Get the base description
         let fullDescription = propDetails.description || '';
         fullDescription = fullDescription.replace(/\n/g, ' ');
+
+        // Collect enum values from enum or x-enum keys
+        const enumValues = propDetails['enum'] || propDetails['x-enum'];
+        if (Array.isArray(enumValues) && enumValues.length > 0) {
+            fullDescription += ` (${enumValues.join(', ')})`;
+        }
+
         let additionalDescriptionPaths = [];
 
         // Add all other fields to description parts
         for (const [fieldName, fieldValue] of Object.entries(propDetails)) {
             // Skip the fields we're handling separately
-            if (fieldName === 'type' || fieldName === 'format' || fieldName === 'description') {
+            if (fieldName === 'type' || fieldName === 'format' || fieldName === 'description' || fieldName === 'enum' || fieldName === 'x-enum') {
                 continue;
             }
 
@@ -360,13 +371,14 @@ function getHttpOperationForSqlVerb(sqlVerbRef, resourceData){
     const httpVerb = operationRef.split('/').pop()
     const path = operationRef.split('/')[0].replaceAll('~1','/');
 
-    return { 
-        path, 
-        httpVerb, 
-        mediaType: methodObj.response.mediaType,  
+    return {
+        path,
+        httpVerb,
+        mediaType: methodObj.response.mediaType,
         openAPIDocKey: methodObj.response.openAPIDocKey,
         objectKey: methodObj.response.objectKey || false,
-        methodName 
+        methodName,
+        methodConfig: methodObj.config || null
     }
 }
 
@@ -383,8 +395,9 @@ function getHttpOperationInfo(dereferencedAPI, path, httpVerb, mediaType, openAP
         throw new Error(`HTTP verb '${httpVerb}' not found for path '${path}'`);
     }
     
-    // Get operation description
+    // Get operation description and summary
     const opDescription = (dereferencedAPI.paths[path][httpVerb].description || '');
+    const opSummary = (dereferencedAPI.paths[path][httpVerb].summary || '');
 
     // Extract request body if it exists
     let requestBody = {};
@@ -474,19 +487,21 @@ function getHttpOperationInfo(dereferencedAPI, path, httpVerb, mediaType, openAP
             respProps: {},
             respDescription: '',
             opDescription,
+            opSummary,
             requestBody
         };
     }
-    
+
     // Check if there's a content section with the mediaType
     const responseObj = dereferencedAPI.paths[path][httpVerb].responses[openAPIDocKey];
-    
+
     // If no content or no mediaType in the response, return empty properties
     if (!responseObj.content || !mediaType || !responseObj.content[mediaType] || !responseObj.content[mediaType].schema) {
         return {
             respProps: {},
             respDescription: responseObj.description || '',
             opDescription,
+            opSummary,
             requestBody
         };
     }
@@ -499,6 +514,7 @@ function getHttpOperationInfo(dereferencedAPI, path, httpVerb, mediaType, openAP
         respProps,
         respDescription: responseObj.description ? responseObj.description : respDescription,
         opDescription,
+        opSummary,
         requestBody
     };
 }
@@ -589,6 +605,12 @@ export function generateSchemaJsonFromProps(respProps, depth = 0, maxDepth = 4)
         let propType = prop.type || 'object';
         let propDesc = sanitizeHtml(prop.description || '');
 
+        // Collect enum values from enum or x-enum keys
+        const enumValues = prop['enum'] || prop['x-enum'];
+        if (Array.isArray(enumValues) && enumValues.length > 0) {
+            propDesc += ` (${enumValues.join(', ')})`;
+        }
+
         // Add format info to type string if available
         if (prop.format) {
             propType += ` (${prop.format})`;

package/src/docgen/resource/examples/delete-example.js

@@ -4,7 +4,7 @@ import {
     sanitizeHtml,
 } from '../../helpers.js';
 
-export function createDeleteExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI) {
+export function createDeleteExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI, succinct = false) {
     const deleteMethods = getSqlMethodsWithOrderedFields(resourceData, dereferencedAPI, 'delete');
 
     // if there are no delete methods, return empty content
@@ -30,7 +30,7 @@ export function createDeleteExamples(providerName, serviceName, resourceName, re
         content += '<TabItem value="' + methodName + '">\n\n';
         
         // Add method description
-        const opDescription = methodDetails.opDescription || 'No description available.';
+        const opDescription = (succinct && methodDetails.opSummary) ? methodDetails.opSummary : (methodDetails.opDescription || 'No description available.');
         content += sanitizeHtml(opDescription);
 
         // Create SQL example

package/src/docgen/resource/examples/exec-example.js

@@ -4,7 +4,7 @@ import {
     sanitizeHtml
 } from '../../helpers.js';
 
-export function createExecExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI) {
+export function createExecExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI, succinct = false) {
     const execMethods = getSqlMethodsWithOrderedFields(resourceData, dereferencedAPI, 'exec');
     
     // if there are no exec methods, return empty content
@@ -30,7 +30,7 @@ export function createExecExamples(providerName, serviceName, resourceName, reso
         content += '<TabItem value="' + methodName + '">\n\n';
         
         // Add method description
-        const opDescription = methodDetails.opDescription || methodDetails.respDescription || 'No description available.';
+        const opDescription = (succinct && methodDetails.opSummary) ? methodDetails.opSummary : (methodDetails.opDescription || methodDetails.respDescription || 'No description available.');
         content += sanitizeHtml(opDescription);
         
         // Create SQL example

package/src/docgen/resource/examples/insert-example.js

@@ -4,7 +4,7 @@ import {
     sanitizeHtml
 } from '../../helpers.js';
 
-export function createInsertExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI) {
+export function createInsertExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI, succinct = false) {
     const insertMethods = getSqlMethodsWithOrderedFields(resourceData, dereferencedAPI, 'insert');
 
     // if there are no insert methods, return empty content
@@ -34,23 +34,27 @@ export function createInsertExamples(providerName, serviceName, resourceName, re
         content += '<TabItem value="' + methodName + '">\n\n';
 
         // Add method description
-        const opDescription = methodDetails.opDescription || 'No description available.';
+        const opDescription = (succinct && methodDetails.opSummary) ? methodDetails.opSummary : (methodDetails.opDescription || 'No description available.');
         content += sanitizeHtml(opDescription);
-        // content += methodDetails.opDescription || 'No description available.';
         
         // Create SQL example
         content += '\n\n```sql\nINSERT INTO ' + providerName + '.' + serviceName + '.' + resourceName + ' (\n';
         
-        // Add requestBody fields prefixed with data__ (excluding read-only props)
-        const reqBodyProps = methodDetails.requestBody?.properties 
+        // Add requestBody fields (excluding read-only props)
+        // If requestBodyTranslate.algorithm is 'naive', do not prefix with data__
+        const hasNaiveTranslate = methodDetails.methodConfig?.requestBodyTranslate?.algorithm === 'naive';
+
+        const reqBodyProps = methodDetails.requestBody?.properties
             ? Object.entries(methodDetails.requestBody.properties)
                 .filter(([_, propDetails]) => propDetails.readOnly !== true)
                 .map(([propName]) => propName)
             : [];
 
         const requiredBodyProps = methodDetails.requestBody?.required ? methodDetails.requestBody.required : [];
-            
-        const dataProps = reqBodyProps.map(prop => 'data__' + prop);
+
+        const dataProps = hasNaiveTranslate
+            ? reqBodyProps
+            : reqBodyProps.map(prop => 'data__' + prop);
         
         // Combine data props with params
         const requiredParams = Object.keys(methodDetails.requiredParams || {});
@@ -63,11 +67,18 @@ export function createInsertExamples(providerName, serviceName, resourceName, re
         // Start SELECT statement
         content += '\n)\nSELECT \n';
         
+        // Build a set of body prop names for quick lookup
+        const bodyPropSet = new Set(reqBodyProps);
+
         // Add values placeholders
         const valueLines = allFields.map(field => {
-            const isDataField = field.startsWith('data__');
-            const paramName = isDataField ? field.substring(6) : field;
-            
+            const isDataField = hasNaiveTranslate
+                ? bodyPropSet.has(field)
+                : field.startsWith('data__');
+            const paramName = isDataField
+                ? (hasNaiveTranslate ? field : field.substring(6))
+                : field;
+
             // Check for required body props
             let isRequiredBodyParam = false;
             if(isDataField){
@@ -79,13 +90,13 @@ export function createInsertExamples(providerName, serviceName, resourceName, re
             // Check if it's a number or boolean type
             let isNumber = false;
             let isBoolean = false;
-            
+
             if (isDataField && methodDetails.requestBody?.properties?.[paramName]) {
                 const propType = methodDetails.requestBody.properties[paramName].type;
                 isNumber = propType === 'number' || propType === 'integer';
                 isBoolean = propType === 'boolean';
             }
-            
+
             if (isNumber || isBoolean) {
                 return '{{ ' + paramName + ' }}' + (isRequiredBodyParam ? ' /* required */' : '');
             } else {

package/src/docgen/resource/examples/select-example.js

@@ -4,7 +4,7 @@ import {
     sanitizeHtml
 } from '../../helpers.js';
 
-export function createSelectExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI) {
+export function createSelectExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI, succinct = false) {
     const selectMethods = getSqlMethodsWithOrderedFields(resourceData, dereferencedAPI, 'select');
     
     // if there are no select methods, return empty content
@@ -30,7 +30,7 @@ export function createSelectExamples(providerName, serviceName, resourceName, re
         content += '<TabItem value="' + methodName + '">\n\n';
         // content += methodDetails.opDescription || 'No description available.';
         // Add method description
-        const opDescription = methodDetails.opDescription || methodDetails.respDescription || 'No description available.';
+        const opDescription = (succinct && methodDetails.opSummary) ? methodDetails.opSummary : (methodDetails.opDescription || methodDetails.respDescription || 'No description available.');
         content += sanitizeHtml(opDescription);
 
         // Create SQL example

package/src/docgen/resource/examples/update-example.js

@@ -4,7 +4,7 @@ import {
     sanitizeHtml
 } from '../../helpers.js';
 
-export function createUpdateExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI, isReplace = false) {
+export function createUpdateExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI, isReplace = false, succinct = false) {
     const updateMethods = getSqlMethodsWithOrderedFields(resourceData, dereferencedAPI, isReplace ? 'replace' : 'update');
     
     // if there are no update methods, return empty content
@@ -34,105 +34,108 @@ export function createUpdateExamples(providerName, serviceName, resourceName, re
     Object.entries(updateMethods).forEach(([methodName, methodDetails]) => {
         content += '<TabItem value="' + methodName + '">\n\n';
         
-        // // Add method description
-        // content += methodDetails.opDescription || methodDetails.respDescription || 'No description available.';
         // Add method description
-        const opDescription = methodDetails.opDescription || 'No description available.';
+        const opDescription = (succinct && methodDetails.opSummary) ? methodDetails.opSummary : (methodDetails.opDescription || 'No description available.');
         content += sanitizeHtml(opDescription);
         
         // Create SQL example
         content += '\n\n```sql\n';
         content += (isReplace ? 'REPLACE ' : 'UPDATE ') + providerName + '.' + serviceName + '.' + resourceName;
         
+        // If requestBodyTranslate.algorithm is 'naive', do not prefix with data__
+        const hasNaiveTranslate = methodDetails.methodConfig?.requestBodyTranslate?.algorithm === 'naive';
+
         // Add SET clause with requestBody fields (excluding read-only props)
         content += '\nSET \n';
-        
+
         // Get request body fields (excluding read-only props)
-        const reqBodyProps = methodDetails.requestBody?.properties 
+        const reqBodyProps = methodDetails.requestBody?.properties
             ? Object.entries(methodDetails.requestBody.properties)
                 .filter(([_, propDetails]) => propDetails.readOnly !== true)
                 .map(([propName]) => propName)
             : [];
-        
-        // Add data__ prefixed fields to SET clause
+
+        // Add fields to SET clause (with or without data__ prefix)
         if (reqBodyProps.length > 0) {
             const setLines = reqBodyProps.map(prop => {
                 const propDetails = methodDetails.requestBody.properties[prop];
                 const isNumber = propDetails.type === 'number' || propDetails.type === 'integer';
                 const isBoolean = propDetails.type === 'boolean';
-                
+                const fieldName = hasNaiveTranslate ? prop : 'data__' + prop;
+
                 if (isNumber || isBoolean) {
-                    return 'data__' + prop + ' = {{ ' + prop + ' }}';
+                    return fieldName + ' = {{ ' + prop + ' }}';
                 } else {
-                    return 'data__' + prop + ' = \'{{ ' + prop + ' }}\'';
+                    return fieldName + ' = \'{{ ' + prop + ' }}\'';
                 }
             });
-            
+
             content += setLines.join(',\n');
         } else {
             content += '-- No updatable properties';
         }
-        
+
         // Add WHERE clause with parameters
         const requiredParams = Object.keys(methodDetails.requiredParams || {});
         const optionalParams = Object.keys(methodDetails.optionalParams || {});
-        
+
         // Get required body props (excluding read-only props)
-        const requiredBodyProps = methodDetails.requestBody?.required 
-            ? methodDetails.requestBody.required.filter(prop => 
-                methodDetails.requestBody.properties[prop] && 
+        const requiredBodyProps = methodDetails.requestBody?.required
+            ? methodDetails.requestBody.required.filter(prop =>
+                methodDetails.requestBody.properties[prop] &&
                 methodDetails.requestBody.properties[prop].readOnly !== true)
             : [];
-        
+
         if (requiredParams.length > 0 || requiredBodyProps.length > 0 || optionalParams.length > 0) {
 
             content += '\nWHERE \n';
-            
+
             // Add required parameters
             let clauseCount = 0;
-            
+
             // Add required query/path/header params
             requiredParams.forEach(param => {
                 if (clauseCount > 0) content += '\nAND ';
                 content += param + ' = \'{{ ' + param + ' }}\' --required';
                 clauseCount++;
             });
-            
+
             // Add required body params (only non-readonly ones)
             requiredBodyProps.forEach(prop => {
                 if (clauseCount > 0) content += '\nAND ';
-                
+
                 const propDetails = methodDetails.requestBody.properties[prop];
                 const isBoolean = propDetails.type === 'boolean';
-                
+                const fieldName = hasNaiveTranslate ? prop : 'data__' + prop;
+
                 if (isBoolean) {
-                    content += 'data__' + prop + ' = {{ ' + prop + ' }} --required';
+                    content += fieldName + ' = {{ ' + prop + ' }} --required';
                 } else {
-                    content += 'data__' + prop + ' = \'{{ ' + prop + ' }}\' --required';
+                    content += fieldName + ' = \'{{ ' + prop + ' }}\' --required';
                 }
-                
+
                 clauseCount++;
             });
-            
+
             // Add optional parameters
             optionalParams.forEach(param => {
                 if (clauseCount > 0) content += '\nAND ';
-                
+
                 // For boolean parameters, we can add a comment about their default value
                 const paramDetails = methodDetails.optionalParams[param];
                 const isBoolean = paramDetails.type === 'boolean';
                 const defaultValue = paramDetails.default;
-                
+
                 if (isBoolean) {
                     content += param + ' = {{ ' + param + '}}';
                 } else {
                     content += param + ' = \'{{ ' + param + '}}\'';
                 }
-                
+
                 if (isBoolean && defaultValue !== undefined) {
                     content += ' -- default: ' + defaultValue;
                 }
-                
+
                 clauseCount++;
             });
         }

package/src/docgen/resource/examples.js

@@ -6,26 +6,26 @@ import { createUpdateExamples } from './examples/update-example.js';
 import { createDeleteExamples } from './examples/delete-example.js';
 import { createExecExamples } from './examples/exec-example.js';
 
-export function createExamplesSection(providerName, serviceName, resourceName, resourceData, dereferencedAPI) {
+export function createExamplesSection(providerName, serviceName, resourceName, resourceData, dereferencedAPI, succinct = false) {
     let content = '';
-    
+
     // Add SELECT examples
-    content += createSelectExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI);
+    content += createSelectExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI, succinct);
 
     // Add INSERT examples
-    content += createInsertExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI);
-    
+    content += createInsertExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI, succinct);
+
     // Add UPDATE examples
-    content += createUpdateExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI, false);
-    
+    content += createUpdateExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI, false, succinct);
+
     // Add REPLACE examples
-    content += createUpdateExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI, true);
+    content += createUpdateExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI, true, succinct);
 
     // Add DELETE examples
-    content += createDeleteExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI);
+    content += createDeleteExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI, succinct);
 
     // Add EXEC examples
-    content += createExecExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI);    
+    content += createExecExamples(providerName, serviceName, resourceName, resourceData, dereferencedAPI, succinct);
 
     return content;
 }

package/src/docgen/resource/methods.js

@@ -9,20 +9,23 @@ const getRequiredBodyParams = (methodDetails, accessType) => {
     if (!['insert', 'update', 'replace', 'exec'].includes(accessType)) {
         return [];
     }
-    
+
     // Get required body params if they exist
     const requiredBodyProps = methodDetails.requestBody?.required ? methodDetails.requestBody.required : [];
-    
-    // For insert, update, and replace, prefix with data__
-    if (['insert', 'update', 'replace'].includes(accessType)) {
+
+    // Check if requestBodyTranslate.algorithm is 'naive' - if so, don't prefix with data__
+    const hasNaiveTranslate = methodDetails.methodConfig?.requestBodyTranslate?.algorithm === 'naive';
+
+    // For insert, update, and replace, prefix with data__ (unless naive translate is set)
+    if (['insert', 'update', 'replace'].includes(accessType) && !hasNaiveTranslate) {
         return requiredBodyProps.map(prop => `data__${prop}`);
     } else {
-        // For exec, don't prefix
+        // For exec or naive translate, don't prefix
         return requiredBodyProps;
     }
 };
 
-export function createMethodsSection(resourceData, dereferencedAPI) {
+export function createMethodsSection(resourceData, dereferencedAPI, succinct = false) {
     
     let content = `\n## Methods\n\n`;
 
@@ -80,7 +83,7 @@ export function createMethodsSection(resourceData, dereferencedAPI) {
     <td><CopyableCode code="${accessType}" /></td>
     <td>${requiredParamsStr}</td>
     <td>${optionalParamsStr}</td>
-    <td>${sanitizeHtml(methodDetails.opDescription)}</td>
+    <td>${sanitizeHtml(succinct && methodDetails.opSummary ? methodDetails.opSummary : methodDetails.opDescription)}</td>
 </tr>`;
         }
     };

package/src/docgen/resource-content.js

@@ -26,13 +26,14 @@ export async function createResourceIndexContentv2(
     providerName,
     serviceName,
     resource,
+    succinct = false,
 ) {
     // Generate each section of the documentation (v2 uses SchemaTable for fields)
     const overviewContent = createOverviewSectionv2(resource.name, resource.type, resource.description, providerName, serviceName);
     const fieldsContent = createFieldsSectionv2(resource.type, resource.resourceData, resource.dereferencedAPI);
-    const methodsContent = resource.type === 'Resource' ? createMethodsSection(resource.resourceData, resource.dereferencedAPI) : '';
+    const methodsContent = resource.type === 'Resource' ? createMethodsSection(resource.resourceData, resource.dereferencedAPI, succinct) : '';
     const paramsContent = resource.type === 'Resource' ? createParamsSection(resource.resourceData, resource.dereferencedAPI) : '';
-    const examplesContent = resource.type === 'Resource' ? createExamplesSection(providerName, serviceName, resource.name, resource.resourceData, resource.dereferencedAPI) : '';
+    const examplesContent = resource.type === 'Resource' ? createExamplesSection(providerName, serviceName, resource.name, resource.resourceData, resource.dereferencedAPI, succinct) : '';
 
     // Combine all sections into the final content
     return `${overviewContent}${fieldsContent}${methodsContent}${paramsContent}${examplesContent}`;

package/src/providerdev/generate.js

@@ -177,6 +177,8 @@ export async function generate(options) {
     providerId,
     servers = null,
     providerConfig = null,
+    serviceConfig = null,
+    naiveReqBodyTranslate = false,
     skipFiles = []
   } = options;
 
@@ -217,8 +219,19 @@ export async function generate(options) {
     return false;
   }
   
+  // Parse serviceConfig if provided
+  let serviceConfigJson = null;
+  if (serviceConfig) {
+    try {
+      serviceConfigJson = JSON.parse(serviceConfig);
+    } catch (error) {
+      logger.error(`❌ Failed to parse service config JSON: ${error.message}`);
+      return false;
+    }
+  }
+
   const providerServices = {};
-  
+
   try {
     const files = fs.readdirSync(inputDir);
     
@@ -302,10 +315,22 @@ export async function generate(options) {
           const pathRef = encodeRefPath(pathKey, verb);
           const responseInfo = getSuccessResponseInfo(operation);
           
-          const methodEntry = {
-            operation: { $ref: pathRef },
-            response: responseInfo
-          };
+          const methodEntry = {};
+
+          // Add requestBodyTranslate config for methods with request bodies
+          if (naiveReqBodyTranslate && ['post', 'put', 'patch'].includes(verb)) {
+            // Check if the operation actually has a request body
+            if (operation.requestBody) {
+              methodEntry.config = {
+                requestBodyTranslate: {
+                  algorithm: 'naive'
+                }
+              };
+            }
+          }
+
+          methodEntry.operation = { $ref: pathRef };
+          methodEntry.response = responseInfo;
 
           // Add objectKey to the response info if it exists in the manifest and is for a GET operation
           if (entry.stackql_object_key && verb === 'get') {
@@ -344,7 +369,12 @@ export async function generate(options) {
           return false;
         }
       }
-      
+
+      // Inject x-stackQL-config if serviceConfig is provided
+      if (serviceConfigJson) {
+        spec['x-stackQL-config'] = serviceConfigJson;
+      }
+
       // Write enriched spec (always as YAML, ensuring .yaml extension)
       const outputFilename = filename.endsWith('.json') 
         ? filename.replace(/\.json$/, '.yaml')