serverless-plugin-module-registry 1.0.17 → 1.0.18

package/dist/index.js

@@ -16426,7 +16426,8 @@ var DynamoDBManager = class {
         // Add settings attributes if they exist for this module
         ...settings && {
           settingsSchemaJson: settings.settingsSchemaJson,
-          settingsDefault: settings.settingsDefault
+          settingsDefault: settings.settingsDefault,
+          ...settings.uiHints && { uiHints: settings.uiHints }
         }
       };
       if (settings) {
@@ -17525,18 +17526,21 @@ var RegistryProcessor = class {
         this.logger.warning(`   \u26A0\uFE0F  Could not load settings module for ${moduleName}`);
         return null;
       }
-      const { settingsDefault } = settingsModule;
+      const { settingsDefault, uiHints } = settingsModule;
       this.logger.info(`   \u{1F50D} settingsModule keys: ${Object.keys(settingsModule).join(", ")}`);
       this.logger.info(`   \u{1F50D} settingsDefault value: ${JSON.stringify(settingsDefault)}`);
       if (!settingsDefault) {
         this.logger.warning(`   \u26A0\uFE0F  No settingsDefault export found in ${moduleName}/registry/settings.ts`);
         return null;
       }
-      const settingsSchemaJson = JSON.stringify(this.inferJsonSchema(settingsDefault));
+      const rawSchema = this.inferJsonSchema(settingsDefault);
+      const enrichedSchema = uiHints ? this.enrichSchemaWithHints(rawSchema, uiHints, settingsDefault) : this.addDefaultsToSchema(rawSchema, settingsDefault);
+      const settingsSchemaJson = JSON.stringify(enrichedSchema);
       const settingsEntry = {
         moduleName,
         settingsSchemaJson,
         settingsDefault,
+        uiHints,
         lastUpdated: (/* @__PURE__ */ new Date()).toISOString()
       };
       this.logger.info(`   \u2713 Settings loaded for ${moduleName}: ${JSON.stringify(settingsDefault)}`);
@@ -17631,6 +17635,106 @@ var RegistryProcessor = class {
         return {};
     }
   }
+  /**
+   * Enrich an inferred JSON Schema with uiHints metadata and defaults.
+   * Adds title, description, readOnly, enum labels, and default values.
+   */
+  enrichSchemaWithHints(schema, hints, defaults2) {
+    const enriched = { ...schema };
+    if (hints.title) enriched.title = hints.title;
+    if (hints.description) enriched.description = hints.description;
+    if (enriched.properties && typeof enriched.properties === "object") {
+      enriched.properties = this.enrichProperties(
+        enriched.properties,
+        hints,
+        defaults2,
+        ""
+      );
+    }
+    return enriched;
+  }
+  /**
+   * Recursively enrich schema properties with uiHints metadata.
+   */
+  enrichProperties(properties, hints, defaults2, parentPath) {
+    const readOnlyFields = hints.readOnly || [];
+    const enumLabels = hints.enumLabels || {};
+    const sections = hints.sections || [];
+    const propHints = hints.properties || {};
+    const enriched = {};
+    for (const [key, propSchema] of Object.entries(properties)) {
+      const dotPath = parentPath ? `${parentPath}.${key}` : key;
+      const prop = { ...propSchema };
+      prop.title = prop.title || this.camelCaseToTitle(key);
+      if (propHints[key] && propHints[key].description) {
+        prop.description = propHints[key].description;
+      }
+      if (defaults2 && key in defaults2) {
+        prop.default = defaults2[key];
+      }
+      if (readOnlyFields.includes(dotPath)) {
+        prop.readOnly = true;
+      }
+      const section = sections.find((s) => s.key === key);
+      if (section) {
+        prop.title = section.title;
+        if (section.description) prop.description = section.description;
+      }
+      if (enumLabels[dotPath] && prop.type === "array") {
+        const items = prop.items || {};
+        items.type = "string";
+        items.enum = Object.keys(enumLabels[dotPath]);
+        prop.items = items;
+        prop["x-enumLabels"] = enumLabels[dotPath];
+      }
+      if (prop.type === "object" && prop.properties) {
+        const nestedDefaults = defaults2 && typeof defaults2[key] === "object" && defaults2[key] !== null ? defaults2[key] : {};
+        prop.properties = this.enrichProperties(
+          prop.properties,
+          hints,
+          nestedDefaults,
+          dotPath
+        );
+      }
+      enriched[key] = prop;
+    }
+    return enriched;
+  }
+  /**
+   * Add default values to schema properties (without uiHints).
+   * Fallback for modules without uiHints — still adds auto-generated titles and defaults.
+   */
+  addDefaultsToSchema(schema, defaults2) {
+    const enriched = { ...schema };
+    if (enriched.properties && typeof enriched.properties === "object") {
+      const properties = enriched.properties;
+      const enrichedProps = {};
+      for (const [key, propSchema] of Object.entries(properties)) {
+        const prop = { ...propSchema };
+        prop.title = this.camelCaseToTitle(key);
+        if (defaults2 && key in defaults2) {
+          prop.default = defaults2[key];
+        }
+        if (prop.type === "object" && prop.properties && defaults2 && typeof defaults2[key] === "object") {
+          const nested = this.addDefaultsToSchema(
+            prop,
+            defaults2[key]
+          );
+          Object.assign(prop, nested);
+        }
+        enrichedProps[key] = prop;
+      }
+      enriched.properties = enrichedProps;
+    }
+    return enriched;
+  }
+  /**
+   * Convert a camelCase string to Title Case for auto-generated labels.
+   * e.g., 'serproCredentialsConfigured' → 'Serpro Credentials Configured'
+   */
+  camelCaseToTitle(str) {
+    return str.replace(/([A-Z])/g, " $1").replace(/^./, (s) => s.toUpperCase()).trim();
+  }
   /**
    * Fallback: Parse settings file manually to extract settingsDefault
    * Handles both direct object literals and re-exports from imported variables
@@ -17645,6 +17749,7 @@ var RegistryProcessor = class {
         return null;
       }
       const startIndex = exportMatch.index + exportMatch[0].length;
+      let result = null;
       if (content[startIndex] === "{") {
         const objectLiteral = this.extractBalancedBraces(content, startIndex);
         if (!objectLiteral) {
@@ -17652,7 +17757,7 @@ var RegistryProcessor = class {
           return null;
         }
         this.logger.info(`   \u{1F4E6} Found direct settingsDefault: ${objectLiteral.substring(0, 100)}${objectLiteral.length > 100 ? "..." : ""}`);
-        return this.parseObjectLiteral(objectLiteral);
+        result = this.parseObjectLiteral(objectLiteral);
       } else {
         const varMatch = content.substring(startIndex).match(/^(\w+)/);
         if (!varMatch) {
@@ -17661,13 +17766,44 @@ var RegistryProcessor = class {
         }
         const varName = varMatch[1];
         this.logger.info(`   \u{1F517} settingsDefault references variable: ${varName}`);
-        return this.resolveImportedSettings(settingsFile, content, varName);
+        result = this.resolveImportedSettings(settingsFile, content, varName);
       }
+      if (result) {
+        const uiHints = this.extractUiHints(content);
+        if (uiHints) {
+          result.uiHints = uiHints;
+          this.logger.info(`   \u{1F3A8} Found uiHints: ${JSON.stringify(uiHints).substring(0, 100)}...`);
+        }
+      }
+      return result;
     } catch (readError) {
       this.logger.warning(`   \u26A0\uFE0F Could not read settings file ${settingsFile}: ${readError.message}`);
       return null;
     }
   }
+  /**
+   * Extract uiHints export from a settings file
+   */
+  extractUiHints(content) {
+    const hintsMatch = content.match(/export\s+const\s+uiHints(?:\s*:\s*[\w<>,\s]+)?\s*=\s*/);
+    if (!hintsMatch) {
+      return null;
+    }
+    const startIndex = hintsMatch.index + hintsMatch[0].length;
+    if (content[startIndex] !== "{") {
+      return null;
+    }
+    const objectLiteral = this.extractBalancedBraces(content, startIndex);
+    if (!objectLiteral) {
+      return null;
+    }
+    try {
+      return new Function(`return ${objectLiteral}`)();
+    } catch {
+      this.logger.warning("   \u26A0\uFE0F Could not parse uiHints object literal");
+      return null;
+    }
+  }
   /**
    * Parse an object literal string into a JS object
    */