@living-architecture/riviere-extract-config-published-language 0.7.0

package/dist/published-language/extraction-config-schema.d.ts

@@ -0,0 +1,313 @@
+/**
+ * AST element type to search for during extraction.
+ */
+/** @riviere-role published-language-union */
+export type FindTarget = 'classes' | 'methods' | 'functions';
+/**
+ * Standard architectural component types recognized by the Riviere extractor.
+ * Each type represents a distinct role in the system's flow-based architecture.
+ */
+/** @riviere-role published-language-union */
+export type ComponentType = 'api' | 'useCase' | 'domainOp' | 'event' | 'eventHandler' | 'ui';
+/** Matches elements with a specific decorator. */
+/** @riviere-role published-language-data-structure */
+export interface HasDecoratorPredicate {
+    hasDecorator: {
+        name: string | string[];
+        from?: string;
+    };
+}
+/** Matches elements with a specific JSDoc tag. */
+/** @riviere-role published-language-data-structure */
+export interface HasJSDocPredicate {
+    hasJSDoc: {
+        tag: string;
+    };
+}
+/** Matches classes extending a specific base class. */
+/** @riviere-role published-language-data-structure */
+export interface ExtendsClassPredicate {
+    extendsClass: {
+        name: string;
+    };
+}
+/** Matches classes implementing a specific interface. */
+/** @riviere-role published-language-data-structure */
+export interface ImplementsInterfacePredicate {
+    implementsInterface: {
+        name: string;
+    };
+}
+/** Matches elements whose name ends with a suffix. */
+/** @riviere-role published-language-data-structure */
+export interface NameEndsWithPredicate {
+    nameEndsWith: {
+        suffix: string;
+    };
+}
+/** Matches elements whose name matches a regex pattern. */
+/** @riviere-role published-language-data-structure */
+export interface NameMatchesPredicate {
+    nameMatches: {
+        pattern: string;
+    };
+}
+/** Matches methods inside classes satisfying a predicate. */
+/** @riviere-role published-language-data-structure */
+export interface InClassWithPredicate {
+    inClassWith: Predicate;
+}
+/** Combines predicates with AND logic. */
+/** @riviere-role published-language-data-structure */
+export interface AndPredicate {
+    and: Predicate[];
+}
+/** Combines predicates with OR logic. */
+/** @riviere-role published-language-data-structure */
+export interface OrPredicate {
+    or: Predicate[];
+}
+/** Union of all predicate types for filtering AST elements. */
+/** @riviere-role published-language-union */
+export type Predicate = HasDecoratorPredicate | HasJSDocPredicate | ExtendsClassPredicate | ImplementsInterfacePredicate | NameEndsWithPredicate | NameMatchesPredicate | InClassWithPredicate | AndPredicate | OrPredicate;
+/** Marker indicating a component type is not used in the module. */
+/** @riviere-role published-language-data-structure */
+export interface NotUsed {
+    notUsed: true;
+}
+/** Transform operations to apply to extracted values. */
+/** @riviere-role published-language-data-structure */
+export interface Transform {
+    stripSuffix?: string;
+    stripPrefix?: string;
+    toLowerCase?: true;
+    toUpperCase?: true;
+    kebabToPascal?: true;
+    pascalToKebab?: true;
+}
+/** Extracts a hardcoded literal value. */
+/** @riviere-role published-language-data-structure */
+export interface LiteralExtractionRule {
+    literal: string | boolean | number;
+}
+/** Extracts value from the class name. */
+/** @riviere-role published-language-data-structure */
+export interface FromClassNameExtractionRule {
+    fromClassName: true | {
+        transform?: Transform;
+    };
+}
+/** Extracts value from the method name. */
+/** @riviere-role published-language-data-structure */
+export interface FromMethodNameExtractionRule {
+    fromMethodName: true | {
+        transform?: Transform;
+    };
+}
+/** Extracts value from the file path using regex capture. */
+/** @riviere-role published-language-data-structure */
+export interface FromFilePathExtractionRule {
+    fromFilePath: {
+        pattern: string;
+        capture: number;
+        transform?: Transform;
+    };
+}
+/** Extracts value from a class property. */
+/** @riviere-role published-language-data-structure */
+export interface FromPropertyExtractionRule {
+    fromProperty: {
+        name: string;
+        kind: 'static' | 'instance';
+        transform?: Transform;
+    };
+}
+/** Extracts value from decorator argument. */
+/** @riviere-role published-language-data-structure */
+export interface FromDecoratorArgExtractionRule {
+    fromDecoratorArg: {
+        decorator?: string;
+        position?: number;
+        name?: string;
+        transform?: Transform;
+    };
+}
+/** Extracts value from decorator argument on the containing class. */
+/** @riviere-role published-language-data-structure */
+export interface FromClassDecoratorArgExtractionRule {
+    fromClassDecoratorArg: {
+        decorator: string;
+        position: number;
+        name?: never;
+        transform?: Transform;
+    } | {
+        decorator: string;
+        name: string;
+        position?: never;
+        transform?: Transform;
+    };
+}
+/** Extracts value from the decorator name itself. */
+/** @riviere-role published-language-data-structure */
+export interface FromDecoratorNameExtractionRule {
+    fromDecoratorName: true | {
+        mapping?: Record<string, string>;
+        transform?: Transform;
+    };
+}
+/** Extracts value from generic type argument. */
+/** @riviere-role published-language-data-structure */
+export interface FromGenericArgExtractionRule {
+    fromGenericArg: {
+        interface: string;
+        position: number;
+        transform?: Transform;
+    };
+}
+/** Extracts method parameters and return type. */
+/** @riviere-role published-language-data-structure */
+export interface FromMethodSignatureExtractionRule {
+    fromMethodSignature: true;
+}
+/** Extracts constructor parameter names and types. */
+/** @riviere-role published-language-data-structure */
+export interface FromConstructorParamsExtractionRule {
+    fromConstructorParams: true;
+}
+/** Extracts type name of parameter at position. */
+/** @riviere-role published-language-data-structure */
+export interface FromParameterTypeExtractionRule {
+    fromParameterType: {
+        position: number;
+        transform?: Transform;
+    };
+}
+/**
+ * Union of all extraction rule types.
+ * Each rule type corresponds to a different source of metadata.
+ */
+/** @riviere-role published-language-union */
+export type ExtractionRule = LiteralExtractionRule | FromClassNameExtractionRule | FromMethodNameExtractionRule | FromFilePathExtractionRule | FromPropertyExtractionRule | FromDecoratorArgExtractionRule | FromClassDecoratorArgExtractionRule | 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).
+ */
+/** @riviere-role published-language-data-structure */
+export interface ExtractBlock {
+    [fieldName: string]: ExtractionRule;
+}
+/** Rule specifying what to find and how to filter matches. */
+/** @riviere-role published-language-data-structure */
+export interface DetectionRule {
+    find: FindTarget;
+    where: Predicate;
+    extract?: ExtractBlock;
+}
+/** Either a detection rule or a marker that the component type is unused. */
+/** @riviere-role published-language-union */
+export type ComponentRule = NotUsed | DetectionRule;
+/** User-defined component types with their detection rules. */
+/** @riviere-role published-language-data-structure */
+export interface CustomTypes {
+    [customTypeName: string]: DetectionRule;
+}
+/**
+ * Declares a custom component type as an event publisher.
+ * The component type must be defined in customTypes in at least one module.
+ */
+/** @riviere-role published-language-data-structure */
+export interface EventPublisherConfig {
+    /** The custom component type name (e.g. 'eventPublisher'). */
+    fromType: string;
+    /** The metadata key on this component type that holds the published event type name. */
+    metadataKey: string;
+}
+/**
+ * Declares how to resolve HTTP client calls into cross-domain Links.
+ * The custom type must be defined in customTypes in at least one module.
+ */
+/** @riviere-role published-language-data-structure */
+export interface HttpLinkConfig {
+    /** The custom component type name for HTTP clients (e.g. 'httpCall'). */
+    fromCustomType: string;
+    /** Metadata key whose value identifies the target domain. */
+    matchDomainBy: string;
+    /** Metadata keys used to match the target API component. */
+    matchApiBy: string[];
+}
+/** Connection detection configuration. */
+/** @riviere-role published-language-data-structure */
+export interface ConnectionsConfig {
+    /** Declares which custom component types publish events and how to detect them. */
+    eventPublishers?: EventPublisherConfig[];
+    /** Declares how to resolve HTTP client calls into cross-domain Links. */
+    httpLinks?: HttpLinkConfig[];
+}
+/**
+ * Reference to an external module definition file.
+ * The CLI expands these references before extraction by loading the referenced file.
+ */
+/** @riviere-role published-language-data-structure */
+export interface ModuleRef {
+    $ref: string;
+}
+/**
+ * A module config as written in the extraction config file.
+ * When `extends` is present, component rules are inherited from the extended config.
+ * Local rules override inherited rules.
+ */
+interface ModuleIdentity {
+    name: string;
+    domain: string;
+    path: string;
+    glob: string;
+    /** Path pattern with `{module}` placeholder for resolving module names from file paths. */
+    modules?: string;
+    customTypes?: CustomTypes;
+}
+interface ModuleRules {
+    api: ComponentRule;
+    useCase: ComponentRule;
+    domainOp: ComponentRule;
+    event: ComponentRule;
+    eventHandler: ComponentRule;
+    ui: ComponentRule;
+}
+/** @riviere-role published-language-data-structure */
+export interface StandaloneDraftModule extends ModuleIdentity, ModuleRules {
+    extends?: never;
+}
+/** @riviere-role published-language-union */
+export type DraftModule = StandaloneDraftModule | (ModuleIdentity & Partial<ModuleRules> & {
+    extends: string;
+});
+/**
+ * A fully resolved module with all component rules.
+ * This is what the extractor uses after config resolution.
+ */
+/** @riviere-role published-language-data-structure */
+export interface ValidatedModuleInput extends ModuleIdentity, ModuleRules {
+}
+/**
+ * Extraction config after $ref expansion.
+ * At this point all ModuleRef entries have been resolved to DraftModule.
+ * This is what the extractor uses for processing.
+ */
+/** @riviere-role published-language-schema */
+export interface DraftConfiguration {
+    $schema?: string;
+    modules: DraftModule[];
+    connections?: ConnectionsConfig;
+}
+/**
+ * Fully resolved extraction config ready for the extractor.
+ * All extends references resolved, all modules have complete rules.
+ */
+/** @riviere-role published-language-data-structure */
+export interface ValidatedConfigurationInput {
+    $schema?: string;
+    modules: ValidatedModuleInput[];
+    connections?: ConnectionsConfig;
+}
+export {};
+//# sourceMappingURL=extraction-config-schema.d.ts.map

package/dist/published-language/extraction-config-schema.d.ts.map

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

package/dist/published-language/extraction-config-schema.js

@@ -0,0 +1 @@
+export {};

package/dist/published-language/validated-configuration.d.ts

@@ -0,0 +1,48 @@
+import type { ComponentRule, ComponentType, ConnectionsConfig, CustomTypes, ValidatedConfigurationInput, ValidatedModuleInput } from './extraction-config-schema';
+import type { ValidationError } from './validation';
+type ValidatedModuleParseResult = {
+    success: true;
+    data: ValidatedModule;
+} | {
+    success: false;
+    errors: ValidationError[];
+};
+/** @riviere-role value-object */
+export declare class ValidatedModule {
+    #private;
+    private readonly brand;
+    private constructor();
+    static parse(input: Readonly<ValidatedModuleInput>): ValidatedModuleParseResult;
+    get name(): string;
+    get domain(): string;
+    get path(): string;
+    get glob(): string;
+    get modules(): string | undefined;
+    get api(): ComponentRule;
+    get useCase(): ComponentRule;
+    get domainOp(): ComponentRule;
+    get event(): ComponentRule;
+    get eventHandler(): ComponentRule;
+    get ui(): ComponentRule;
+    get customTypes(): CustomTypes | undefined;
+    ruleFor(componentType: ComponentType): ComponentRule;
+}
+type ValidatedConfigurationParseResult = {
+    success: true;
+    data: ValidatedConfiguration;
+} | {
+    success: false;
+    errors: ValidationError[];
+};
+/** @riviere-role value-object */
+export declare class ValidatedConfiguration {
+    #private;
+    readonly connections: ConnectionsConfig | undefined;
+    readonly schema: string | undefined;
+    private readonly brand;
+    private constructor();
+    static parse(input: Readonly<ValidatedConfigurationInput>): ValidatedConfigurationParseResult;
+    get modules(): readonly ValidatedModule[];
+}
+export {};
+//# sourceMappingURL=validated-configuration.d.ts.map

package/dist/published-language/validated-configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validated-configuration.d.ts","sourceRoot":"","sources":["../../src/published-language/validated-configuration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,2BAA2B,EAC3B,oBAAoB,EACrB,MAAM,4BAA4B,CAAA;AACnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAoBnD,KAAK,0BAA0B,GAC3B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GACxC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAAA;AAEjD,iCAAiC;AACjC,qBAAa,eAAe;;IAC1B,iBAAyB,KAAK,CAAmB;IAGjD,OAAO;IAIP,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,0BAA0B;IAQ/E,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAEhC;IAED,IAAI,GAAG,IAAI,aAAa,CAEvB;IAED,IAAI,OAAO,IAAI,aAAa,CAE3B;IAED,IAAI,QAAQ,IAAI,aAAa,CAE5B;IAED,IAAI,KAAK,IAAI,aAAa,CAEzB;IAED,IAAI,YAAY,IAAI,aAAa,CAEhC;IAED,IAAI,EAAE,IAAI,aAAa,CAEtB;IAED,IAAI,WAAW,IAAI,WAAW,GAAG,SAAS,CAEzC;IAED,OAAO,CAAC,aAAa,EAAE,aAAa,GAAG,aAAa;CAGrD;AAED,KAAK,iCAAiC,GAClC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,sBAAsB,CAAA;CAAE,GAC/C;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAAA;AAEjD,iCAAiC;AACjC,qBAAa,sBAAsB;;IAM/B,QAAQ,CAAC,WAAW,EAAE,iBAAiB,GAAG,SAAS;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IANrC,iBAAyB,KAAK,CAA0B;IAGxD,OAAO;IAQP,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,2BAA2B,CAAC,GAAG,iCAAiC;IA4B7F,IAAI,OAAO,IAAI,SAAS,eAAe,EAAE,CAExC;CACF"}

package/dist/published-language/validated-configuration.js

@@ -0,0 +1,186 @@
+const REQUIRED_FIELDS = {
+    api: ['apiType'],
+    useCase: [],
+    domainOp: ['operationName'],
+    event: ['eventName'],
+    eventHandler: ['subscribedEvents'],
+    ui: ['route'],
+};
+const COMPONENT_TYPES = [
+    'api',
+    'useCase',
+    'domainOp',
+    'event',
+    'eventHandler',
+    'ui',
+];
+/** @riviere-role value-object */
+export class ValidatedModule {
+    #values;
+    constructor(values) {
+        this.#values = values;
+    }
+    static parse(input) {
+        const errors = validateModule(input);
+        if (errors.length > 0) {
+            return { success: false, errors };
+        }
+        return { success: true, data: new ValidatedModule(input) };
+    }
+    get name() {
+        return this.#values.name;
+    }
+    get domain() {
+        return this.#values.domain;
+    }
+    get path() {
+        return this.#values.path;
+    }
+    get glob() {
+        return this.#values.glob;
+    }
+    get modules() {
+        return this.#values.modules;
+    }
+    get api() {
+        return this.#values.api;
+    }
+    get useCase() {
+        return this.#values.useCase;
+    }
+    get domainOp() {
+        return this.#values.domainOp;
+    }
+    get event() {
+        return this.#values.event;
+    }
+    get eventHandler() {
+        return this.#values.eventHandler;
+    }
+    get ui() {
+        return this.#values.ui;
+    }
+    get customTypes() {
+        return this.#values.customTypes;
+    }
+    ruleFor(componentType) {
+        return this.#values[componentType];
+    }
+}
+/** @riviere-role value-object */
+export class ValidatedConfiguration {
+    connections;
+    schema;
+    #modules;
+    constructor(modules, connections, schema) {
+        this.connections = connections;
+        this.schema = schema;
+        this.#modules = modules;
+    }
+    static parse(input) {
+        const modules = [];
+        const moduleErrors = [];
+        input.modules.forEach((module, index) => {
+            const result = ValidatedModule.parse(module);
+            if (result.success) {
+                modules.push(result.data);
+                return;
+            }
+            moduleErrors.push(...result.errors.map((error) => ({
+                ...error,
+                path: `/modules/${index}${error.path}`,
+            })));
+        });
+        const connectionErrors = validateConnections(input);
+        const errors = [...moduleErrors, ...connectionErrors];
+        if (errors.length > 0) {
+            return { success: false, errors };
+        }
+        return {
+            success: true,
+            data: new ValidatedConfiguration(modules, input.connections, input.$schema),
+        };
+    }
+    get modules() {
+        return this.#modules;
+    }
+}
+function validateModule(module) {
+    return COMPONENT_TYPES.flatMap((componentType) => {
+        const rule = module[componentType];
+        if ('notUsed' in rule) {
+            return [];
+        }
+        const extractedFields = new Set(Object.keys(rule.extract ?? {}));
+        const missingFields = REQUIRED_FIELDS[componentType].filter((field) => !extractedFields.has(field));
+        return missingFields.length === 0
+            ? []
+            : [
+                {
+                    path: `/${componentType}`,
+                    message: `Missing required extraction rules: ${missingFields.join(', ')}. ` +
+                        `Add extraction rules to the 'extract' block or use 'notUsed: true' if not extracting ${componentType} components.`,
+                },
+            ];
+    });
+}
+function validateConnections(input) {
+    if (input.connections === undefined)
+        return [];
+    const customTypeFields = new Map();
+    for (const module of input.modules) {
+        for (const [typeName, rule] of Object.entries(module.customTypes ?? {})) {
+            const fields = customTypeFields.get(typeName) ?? new Set();
+            for (const field of Object.keys(rule.extract ?? {}))
+                fields.add(field);
+            customTypeFields.set(typeName, fields);
+        }
+    }
+    return [
+        ...validateEventPublishers(input.connections, customTypeFields),
+        ...validateHttpLinks(input.connections, customTypeFields),
+    ];
+}
+function validateEventPublishers(connections, customTypeFields) {
+    return (connections.eventPublishers ?? []).flatMap((publisher, index) => {
+        const fields = customTypeFields.get(publisher.fromType);
+        if (fields === undefined) {
+            return [
+                {
+                    path: `/connections/eventPublishers/${index}/fromType`,
+                    message: `"${publisher.fromType}" is not defined as a customType in any module.`,
+                },
+            ];
+        }
+        return fields.has(publisher.metadataKey)
+            ? []
+            : [
+                {
+                    path: `/connections/eventPublishers/${index}/metadataKey`,
+                    message: `customType "${publisher.fromType}" does not extract "${publisher.metadataKey}".`,
+                },
+            ];
+    });
+}
+function validateHttpLinks(connections, customTypeFields) {
+    return (connections.httpLinks ?? []).flatMap((httpLink, index) => {
+        const fields = customTypeFields.get(httpLink.fromCustomType);
+        if (fields === undefined) {
+            return [
+                {
+                    path: `/connections/httpLinks/${index}/fromCustomType`,
+                    message: `"${httpLink.fromCustomType}" is not defined as a customType in any module.`,
+                },
+            ];
+        }
+        const requiredFields = [httpLink.matchDomainBy, ...httpLink.matchApiBy];
+        return requiredFields.flatMap((field) => fields.has(field)
+            ? []
+            : [
+                {
+                    path: `/connections/httpLinks/${index}`,
+                    message: `customType "${httpLink.fromCustomType}" does not extract "${field}".`,
+                },
+            ]);
+    });
+}

package/dist/published-language/validation.d.ts

@@ -0,0 +1,36 @@
+import type { DraftConfiguration } from './extraction-config-schema';
+/** A validation error with JSON path and message. */
+/** @riviere-role published-language-data-structure */
+export interface ValidationError {
+    path: string;
+    message: string;
+}
+/**
+ * Parses an extraction configuration against the structural schema.
+ *
+ * @riviere-role published-language-parser
+ * @param data - Configuration value to parse
+ * @returns The draft configuration or its validation errors
+ */
+export declare function parseExtractionConfigSchema(data: unknown): {
+    success: true;
+    configuration: DraftConfiguration;
+} | {
+    success: false;
+    errors: ValidationError[];
+};
+/**
+ * Parses and semantically validates an extraction configuration.
+ *
+ * @riviere-role published-language-parser
+ * @param data - Configuration value to parse
+ * @returns The draft configuration or its validation errors
+ */
+export declare function parseExtractionConfig(data: unknown): {
+    success: true;
+    configuration: DraftConfiguration;
+} | {
+    success: false;
+    errors: ValidationError[];
+};
+//# sourceMappingURL=validation.d.ts.map

package/dist/published-language/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/published-language/validation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,kBAAkB,EAGnB,MAAM,4BAA4B,CAAA;AAuCnC,qDAAqD;AACrD,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAwPD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,OAAO,GAEX;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,aAAa,EAAE,kBAAkB,CAAA;CAAE,GACpD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAMhD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,OAAO,GAEX;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,aAAa,EAAE,kBAAkB,CAAA;CAAE,GACpD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAMhD"}