@living-architecture/riviere-extract-config 0.3.3 → 0.3.4

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export * from './types';
-export { isValidExtractionConfig, validateExtractionConfig, parseExtractionConfig, formatValidationErrors, mapAjvErrors, ExtractionConfigValidationError, type ValidationError, type ValidationResult, } from './validation';
+export { isValidExtractionConfig, validateExtractionConfig, validateExtractionConfigSchema, parseExtractionConfig, formatValidationErrors, mapAjvErrors, ExtractionConfigValidationError, type ValidationError, type ValidationResult, } from './validation';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,YAAY,EACZ,+BAA+B,EAC/B,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,EAC9B,qBAAqB,EACrB,sBAAsB,EACtB,YAAY,EACZ,+BAA+B,EAC/B,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -1,2 +1,2 @@
 export * from './types';
-export { isValidExtractionConfig, validateExtractionConfig, parseExtractionConfig, formatValidationErrors, mapAjvErrors, ExtractionConfigValidationError, } from './validation';
+export { isValidExtractionConfig, validateExtractionConfig, validateExtractionConfigSchema, parseExtractionConfig, formatValidationErrors, mapAjvErrors, ExtractionConfigValidationError, } from './validation';

package/dist/types.d.ts

@@ -62,10 +62,100 @@ export type Predicate = HasDecoratorPredicate | HasJSDocPredicate | ExtendsClass
 export interface NotUsed {
     notUsed: true;
 }
+/** Transform operations to apply to extracted values. */
+export interface Transform {
+    stripSuffix?: string;
+    stripPrefix?: string;
+    toLowerCase?: true;
+    toUpperCase?: true;
+    kebabToPascal?: true;
+    pascalToKebab?: true;
+}
+/** Extracts a hardcoded literal value. */
+export interface LiteralExtractionRule {
+    literal: string | boolean | number;
+}
+/** Extracts value from the class name. */
+export interface FromClassNameExtractionRule {
+    fromClassName: true | {
+        transform?: Transform;
+    };
+}
+/** Extracts value from the method name. */
+export interface FromMethodNameExtractionRule {
+    fromMethodName: true | {
+        transform?: Transform;
+    };
+}
+/** Extracts value from the file path using regex capture. */
+export interface FromFilePathExtractionRule {
+    fromFilePath: {
+        pattern: string;
+        capture: number;
+        transform?: Transform;
+    };
+}
+/** Extracts value from a class property. */
+export interface FromPropertyExtractionRule {
+    fromProperty: {
+        name: string;
+        kind: 'static' | 'instance';
+        transform?: Transform;
+    };
+}
+/** Extracts value from decorator argument. */
+export interface FromDecoratorArgExtractionRule {
+    fromDecoratorArg: {
+        position?: number;
+        name?: string;
+        transform?: Transform;
+    };
+}
+/** Extracts value from the decorator name itself. */
+export interface FromDecoratorNameExtractionRule {
+    fromDecoratorName: true | {
+        mapping?: Record<string, string>;
+        transform?: Transform;
+    };
+}
+/** Extracts value from generic type argument. */
+export interface FromGenericArgExtractionRule {
+    fromGenericArg: {
+        interface: string;
+        position: number;
+        transform?: Transform;
+    };
+}
+/** Extracts method parameters and return type. */
+export interface FromMethodSignatureExtractionRule {
+    fromMethodSignature: true;
+}
+/** Extracts constructor parameter names and types. */
+export interface FromConstructorParamsExtractionRule {
+    fromConstructorParams: true;
+}
+/** Extracts type name of parameter at position. */
+export interface FromParameterTypeExtractionRule {
+    fromParameterType: {
+        position: number;
+        transform?: Transform;
+    };
+}
+/**
+ * Union of all extraction rule types.
+ * Each rule type corresponds to a different source of metadata.
+ */
+export type ExtractionRule = LiteralExtractionRule | FromClassNameExtractionRule | FromMethodNameExtractionRule | FromFilePathExtractionRule | FromPropertyExtractionRule | FromDecoratorArgExtractionRule | FromDecoratorNameExtractionRule | FromGenericArgExtractionRule | FromMethodSignatureExtractionRule | FromConstructorParamsExtractionRule | FromParameterTypeExtractionRule;
+/**
+ * Extract block mapping field names to extraction rules.
+ * Each key is a Riviere schema field name (e.g., apiType, httpMethod, path).
+ */
+export type ExtractBlock = Record<string, ExtractionRule>;
 /** Rule specifying what to find and how to filter matches. */
 export interface DetectionRule {
     find: FindTarget;
     where: Predicate;
+    extract?: ExtractBlock;
 }
 /** Either a detection rule or a marker that the component type is unused. */
 export type ComponentRule = NotUsed | DetectionRule;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/validation.d.ts

@@ -31,8 +31,18 @@ interface AjvErrorLike {
  * @returns Array of ValidationError objects.
  */
 export declare function mapAjvErrors(errors: AjvErrorLike[] | null | undefined): ValidationError[];
+/**
+ * Validates data against the ExtractionConfig JSON Schema only.
+ * Does NOT check semantic rules like required extraction fields.
+ * Use validateExtractionConfig() for full validation.
+ * @param data - Data to validate.
+ * @returns Validation result with errors if invalid.
+ */
+export declare function validateExtractionConfigSchema(data: unknown): ValidationResult;
 /**
  * Validates data against the ExtractionConfig schema.
+ * Performs both JSON Schema validation and semantic validation
+ * for required extraction rules.
  * @param data - Data to validate.
  * @returns Validation result with errors if invalid.
  */

package/dist/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAQ/C;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,gBAAgB,CAE/E;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,mDAAmD;AACnD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,eAAe,EAAE,CAAA;CAC1B;AAED,4DAA4D;AAC5D,qBAAa,+BAAgC,SAAQ,KAAK;aAE5B,MAAM,EAAE,eAAe,EAAE;IADrD,mEAAmE;gBACvC,MAAM,EAAE,eAAe,EAAE;CAItD;AASD,UAAU,YAAY;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,eAAe,EAAE,CAQzF;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAaxE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAExE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAMrE"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACoB,gBAAgB,EAC/C,MAAM,SAAS,CAAA;AA8BhB;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,gBAAgB,CAE/E;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,mDAAmD;AACnD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,eAAe,EAAE,CAAA;CAC1B;AAED,4DAA4D;AAC5D,qBAAa,+BAAgC,SAAQ,KAAK;aAE5B,MAAM,EAAE,eAAe,EAAE;IADrD,mEAAmE;gBACvC,MAAM,EAAE,eAAe,EAAE;CAItD;AASD,UAAU,YAAY;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,eAAe,EAAE,CAQzF;AAgED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAa9E;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAqBxE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAExE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAMrE"}

package/dist/validation.js

@@ -1,6 +1,26 @@
 import Ajv from 'ajv';
 import addFormats from 'ajv-formats';
 import rawSchema from '../extraction-config.schema.json' with { type: 'json' };
+/**
+ * Required extraction fields by component type.
+ * These fields must have extraction rules defined (unless notUsed: true).
+ */
+const REQUIRED_FIELDS = {
+    api: ['apiType'],
+    event: ['eventName'],
+    eventHandler: ['subscribedEvents'],
+    domainOp: ['operationName'],
+    ui: ['route'],
+    useCase: [],
+};
+const COMPONENT_TYPES = [
+    'api',
+    'useCase',
+    'domainOp',
+    'event',
+    'eventHandler',
+    'ui',
+];
 const ajv = new Ajv({ allErrors: true });
 addFormats(ajv);
 const validate = ajv.compile(rawSchema);
@@ -42,22 +62,96 @@ export function mapAjvErrors(errors) {
         message: e.message ?? 'unknown error',
     }));
 }
+function isNotUsed(rule) {
+    return rule !== undefined && 'notUsed' in rule && rule.notUsed === true;
+}
+function hasDetectionRule(rule) {
+    return rule !== undefined && 'find' in rule && 'where' in rule;
+}
+function getExtractedFields(rule) {
+    if (!rule || !('extract' in rule) || !rule.extract) {
+        return [];
+    }
+    return Object.keys(rule.extract);
+}
+function validateModuleExtractionRules(module, moduleIndex) {
+    const errors = [];
+    for (const componentType of COMPONENT_TYPES) {
+        const rule = module[componentType];
+        if (isNotUsed(rule)) {
+            continue;
+        }
+        if (!hasDetectionRule(rule)) {
+            continue;
+        }
+        const requiredFields = REQUIRED_FIELDS[componentType];
+        if (requiredFields.length === 0) {
+            continue;
+        }
+        const extractedFields = getExtractedFields(rule);
+        const missingFields = requiredFields.filter((field) => !extractedFields.includes(field));
+        if (missingFields.length > 0) {
+            errors.push({
+                path: `/modules/${moduleIndex}/${componentType}`,
+                message: `Missing required extraction rules: ${missingFields.join(', ')}. ` +
+                    `Add extraction rules to the 'extract' block or use 'notUsed: true' if not extracting ${componentType} components.`,
+            });
+        }
+    }
+    return errors;
+}
+function validateAllExtractionRules(config) {
+    return config.modules.flatMap((module, index) => {
+        if ('$ref' in module) {
+            return [];
+        }
+        return validateModuleExtractionRules(module, index);
+    });
+}
+/**
+ * Validates data against the ExtractionConfig JSON Schema only.
+ * Does NOT check semantic rules like required extraction fields.
+ * Use validateExtractionConfig() for full validation.
+ * @param data - Data to validate.
+ * @returns Validation result with errors if invalid.
+ */
+export function validateExtractionConfigSchema(data) {
+    const schemaValid = validate(data) === true;
+    if (!schemaValid) {
+        return {
+            valid: false,
+            errors: mapAjvErrors(validate.errors),
+        };
+    }
+    return {
+        valid: true,
+        errors: [],
+    };
+}
 /**
  * Validates data against the ExtractionConfig schema.
+ * Performs both JSON Schema validation and semantic validation
+ * for required extraction rules.
  * @param data - Data to validate.
  * @returns Validation result with errors if invalid.
  */
 export function validateExtractionConfig(data) {
-    const valid = validate(data) === true;
-    if (valid) {
+    // Type guard validates schema AND narrows type in one step
+    if (!isValidExtractionConfig(data)) {
+        // Get detailed error messages from schema validation
+        return validateExtractionConfigSchema(data);
+    }
+    // data is now narrowed to ExtractionConfig
+    const semanticErrors = validateAllExtractionRules(data);
+    if (semanticErrors.length > 0) {
         return {
-            valid: true,
-            errors: [],
+            valid: false,
+            errors: semanticErrors,
         };
     }
     return {
-        valid: false,
-        errors: mapAjvErrors(validate.errors),
+        valid: true,
+        errors: [],
     };
 }
 /**

package/extraction-config.schema.json

@@ -132,6 +132,241 @@
         },
         "where": {
           "$ref": "#/$defs/predicate"
+        },
+        "extract": {
+          "$ref": "#/$defs/extractBlock",
+          "description": "Extraction rules for metadata fields"
+        }
+      }
+    },
+    "extractBlock": {
+      "type": "object",
+      "description": "Extraction rules mapping field names to extraction rules",
+      "additionalProperties": {
+        "$ref": "#/$defs/extractionRule"
+      }
+    },
+    "extractionRule": {
+      "oneOf": [
+        { "$ref": "#/$defs/literalExtractionRule" },
+        { "$ref": "#/$defs/fromClassNameExtractionRule" },
+        { "$ref": "#/$defs/fromMethodNameExtractionRule" },
+        { "$ref": "#/$defs/fromFilePathExtractionRule" },
+        { "$ref": "#/$defs/fromPropertyExtractionRule" },
+        { "$ref": "#/$defs/fromDecoratorArgExtractionRule" },
+        { "$ref": "#/$defs/fromDecoratorNameExtractionRule" },
+        { "$ref": "#/$defs/fromGenericArgExtractionRule" },
+        { "$ref": "#/$defs/fromMethodSignatureExtractionRule" },
+        { "$ref": "#/$defs/fromConstructorParamsExtractionRule" },
+        { "$ref": "#/$defs/fromParameterTypeExtractionRule" }
+      ]
+    },
+    "fromMethodNameExtractionRule": {
+      "type": "object",
+      "description": "Extracts value from the method name",
+      "required": ["fromMethodName"],
+      "additionalProperties": false,
+      "properties": {
+        "fromMethodName": {
+          "oneOf": [
+            { "type": "boolean", "const": true },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "transform": { "$ref": "#/$defs/transform" }
+              }
+            }
+          ]
+        }
+      }
+    },
+    "fromFilePathExtractionRule": {
+      "type": "object",
+      "description": "Extracts value from the file path using regex capture",
+      "required": ["fromFilePath"],
+      "additionalProperties": false,
+      "properties": {
+        "fromFilePath": {
+          "type": "object",
+          "required": ["pattern", "capture"],
+          "additionalProperties": false,
+          "properties": {
+            "pattern": { "type": "string", "minLength": 1 },
+            "capture": { "type": "integer", "minimum": 0 },
+            "transform": { "$ref": "#/$defs/transform" }
+          }
+        }
+      }
+    },
+    "fromPropertyExtractionRule": {
+      "type": "object",
+      "description": "Extracts value from a class property",
+      "required": ["fromProperty"],
+      "additionalProperties": false,
+      "properties": {
+        "fromProperty": {
+          "type": "object",
+          "required": ["name", "kind"],
+          "additionalProperties": false,
+          "properties": {
+            "name": { "type": "string", "minLength": 1 },
+            "kind": { "type": "string", "enum": ["static", "instance"] },
+            "transform": { "$ref": "#/$defs/transform" }
+          }
+        }
+      }
+    },
+    "fromDecoratorArgExtractionRule": {
+      "type": "object",
+      "description": "Extracts value from decorator argument",
+      "required": ["fromDecoratorArg"],
+      "additionalProperties": false,
+      "properties": {
+        "fromDecoratorArg": {
+          "type": "object",
+          "additionalProperties": false,
+          "minProperties": 1,
+          "properties": {
+            "position": { "type": "integer", "minimum": 0 },
+            "name": { "type": "string", "minLength": 1 },
+            "transform": { "$ref": "#/$defs/transform" }
+          }
+        }
+      }
+    },
+    "fromDecoratorNameExtractionRule": {
+      "type": "object",
+      "description": "Extracts value from the decorator name itself",
+      "required": ["fromDecoratorName"],
+      "additionalProperties": false,
+      "properties": {
+        "fromDecoratorName": {
+          "oneOf": [
+            { "type": "boolean", "const": true },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "mapping": {
+                  "type": "object",
+                  "additionalProperties": { "type": "string" },
+                  "minProperties": 1
+                },
+                "transform": { "$ref": "#/$defs/transform" }
+              }
+            }
+          ]
+        }
+      }
+    },
+    "fromGenericArgExtractionRule": {
+      "type": "object",
+      "description": "Extracts value from generic type argument",
+      "required": ["fromGenericArg"],
+      "additionalProperties": false,
+      "properties": {
+        "fromGenericArg": {
+          "type": "object",
+          "required": ["interface", "position"],
+          "additionalProperties": false,
+          "properties": {
+            "interface": { "type": "string", "minLength": 1 },
+            "position": { "type": "integer", "minimum": 0 },
+            "transform": { "$ref": "#/$defs/transform" }
+          }
+        }
+      }
+    },
+    "fromMethodSignatureExtractionRule": {
+      "type": "object",
+      "description": "Extracts method parameters and return type",
+      "required": ["fromMethodSignature"],
+      "additionalProperties": false,
+      "properties": {
+        "fromMethodSignature": {
+          "type": "boolean",
+          "const": true
+        }
+      }
+    },
+    "fromConstructorParamsExtractionRule": {
+      "type": "object",
+      "description": "Extracts constructor parameter names and types",
+      "required": ["fromConstructorParams"],
+      "additionalProperties": false,
+      "properties": {
+        "fromConstructorParams": {
+          "type": "boolean",
+          "const": true
+        }
+      }
+    },
+    "fromParameterTypeExtractionRule": {
+      "type": "object",
+      "description": "Extracts type name of parameter at position",
+      "required": ["fromParameterType"],
+      "additionalProperties": false,
+      "properties": {
+        "fromParameterType": {
+          "type": "object",
+          "required": ["position"],
+          "additionalProperties": false,
+          "properties": {
+            "position": { "type": "integer", "minimum": 0 },
+            "transform": { "$ref": "#/$defs/transform" }
+          }
+        }
+      }
+    },
+    "fromClassNameExtractionRule": {
+      "type": "object",
+      "description": "Extracts value from the class name",
+      "required": ["fromClassName"],
+      "additionalProperties": false,
+      "properties": {
+        "fromClassName": {
+          "oneOf": [
+            { "type": "boolean", "const": true },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "transform": { "$ref": "#/$defs/transform" }
+              }
+            }
+          ],
+          "description": "Extract from class name, optionally with transform"
+        }
+      }
+    },
+    "transform": {
+      "type": "object",
+      "description": "Transform operations to apply to extracted value",
+      "additionalProperties": false,
+      "minProperties": 1,
+      "properties": {
+        "stripSuffix": { "type": "string", "minLength": 1 },
+        "stripPrefix": { "type": "string", "minLength": 1 },
+        "toLowerCase": { "type": "boolean", "const": true },
+        "toUpperCase": { "type": "boolean", "const": true },
+        "kebabToPascal": { "type": "boolean", "const": true },
+        "pascalToKebab": { "type": "boolean", "const": true }
+      }
+    },
+    "literalExtractionRule": {
+      "type": "object",
+      "description": "Extracts a hardcoded literal value",
+      "required": ["literal"],
+      "additionalProperties": false,
+      "properties": {
+        "literal": {
+          "oneOf": [
+            { "type": "string", "minLength": 1 },
+            { "type": "boolean" },
+            { "type": "number" }
+          ],
+          "description": "Literal value to use for this field"
         }
       }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@living-architecture/riviere-extract-config",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "type": "module",
   "publishConfig": {
     "access": "public"