@thymian/core 0.0.0-PLACEHOLDER

package/dist/rules/rule-violation.d.ts

@@ -0,0 +1,22 @@
+import type { RuleSeverity } from './rule-severity.js';
+export type RuleViolationLocation = {
+    elementType: 'node' | 'edge';
+    elementId: string;
+    pointer?: string;
+    label?: string;
+} | string;
+export type RuleViolation = {
+    location: RuleViolationLocation;
+    message?: string;
+};
+/**
+ * A rule violation enriched with the rule name and resolved severity
+ * from the rule runner. This is the type returned by `runRules()`.
+ */
+export type EvaluatedRuleViolation = {
+    ruleName: string;
+    severity: Exclude<RuleSeverity, 'off'>;
+    violation: Required<RuleViolation>;
+};
+export type RuleFnResult = undefined | RuleViolation | RuleViolation[];
+//# sourceMappingURL=rule-violation.d.ts.map

package/dist/rules/rule-violation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-violation.d.ts","sourceRoot":"","sources":["../../src/rules/rule-violation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,MAAM,qBAAqB,GAC7B;IACE,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACD,MAAM,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,qBAAqB,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACvC,SAAS,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,aAAa,GAAG,aAAa,EAAE,CAAC"}

package/dist/rules/rule-violation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rule-violation.js.map

package/dist/rules/rule-violation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-violation.js","sourceRoot":"","sources":["../../src/rules/rule-violation.ts"],"names":[],"mappings":""}

package/dist/rules/rule.d.ts

@@ -0,0 +1,10 @@
+import type { AnalyzeContext, LintContext, TestContext } from './contexts.js';
+import type { RuleFn } from './rule-fn.js';
+import type { RuleMeta } from './rule-meta.js';
+export type Rule<Options extends Record<PropertyKey, unknown> = Record<PropertyKey, unknown>> = {
+    lintRule?: RuleFn<LintContext, Options>;
+    analyzeRule?: RuleFn<AnalyzeContext, Options>;
+    testRule?: RuleFn<TestContext, Options>;
+    meta: RuleMeta<Options>;
+};
+//# sourceMappingURL=rule.d.ts.map

package/dist/rules/rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule.d.ts","sourceRoot":"","sources":["../../src/rules/rule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,MAAM,IAAI,CACd,OAAO,SAAS,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,IACzE;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACxC,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;CACzB,CAAC"}

package/dist/rules/rule.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rule.js.map

package/dist/rules/rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule.js","sourceRoot":"","sources":["../../src/rules/rule.ts"],"names":[],"mappings":""}

package/dist/rules/traffic.d.ts

@@ -0,0 +1,25 @@
+import type { HttpRequest, HttpResponse } from '../http.js';
+import type { HttpParticipantRole } from './rule-meta.js';
+export type CapturedHttpRequest = {
+    data: HttpRequest;
+    meta: {
+        role?: HttpParticipantRole;
+    };
+};
+export type CapturedHttpResponse = {
+    data: HttpResponse;
+    meta: {
+        role?: HttpParticipantRole;
+    };
+};
+export type CapturedTransaction = {
+    request: CapturedHttpRequest;
+    response: CapturedHttpResponse;
+};
+export type CapturedTrace = CapturedTransaction[];
+export interface LoadedTraffic {
+    transactions?: CapturedTransaction[];
+    traces?: CapturedTrace[];
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=traffic.d.ts.map

package/dist/rules/traffic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traffic.d.ts","sourceRoot":"","sources":["../../src/rules/traffic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE;QACJ,IAAI,CAAC,EAAE,mBAAmB,CAAC;KAC5B,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE;QACJ,IAAI,CAAC,EAAE,mBAAmB,CAAC;KAC5B,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,QAAQ,EAAE,oBAAoB,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,mBAAmB,EAAE,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACrC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/rules/traffic.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=traffic.js.map

package/dist/rules/traffic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traffic.js","sourceRoot":"","sources":["../../src/rules/traffic.ts"],"names":[],"mappings":""}

package/dist/thymian-plugin.d.ts

@@ -0,0 +1,38 @@
+import type { JSONSchemaType } from 'ajv/dist/2020.js';
+import type { ThymianActionName, ThymianActions } from './actions/index.js';
+import { ThymianEmitter } from './emitter/index.js';
+import type { ThymianEventName, ThymianEvents } from './events/index.js';
+import type { Logger } from './logger/logger.js';
+export type ThymianPluginFn<Options extends Record<PropertyKey, unknown> & {
+    cwd: string;
+}> = (emitter: ThymianEmitter, logger: Logger, options: Options) => Promise<void>;
+export type ThymianPluginEvents = {
+    provides?: {
+        [Name in ThymianEventName]?: JSONSchemaType<Name extends keyof ThymianEvents ? ThymianEvents[Name] : unknown>;
+    };
+    emits?: ThymianEventName[];
+    listensOn?: ThymianEventName[];
+};
+export type ThymianPluginActions = {
+    provides?: {
+        [Name in ThymianActionName]?: {
+            event: JSONSchemaType<Name extends keyof ThymianActions ? ThymianActions[Name]['event'] : unknown>;
+            response: JSONSchemaType<Name extends keyof ThymianActions ? ThymianActions[Name]['response'] : unknown>;
+        };
+    };
+    emits?: ThymianActionName[];
+    requires?: ThymianActionName[];
+    listensOn?: ThymianActionName[];
+};
+export type ThymianPlugin<Options extends Record<PropertyKey, unknown> = Record<PropertyKey, unknown>> = {
+    plugin: ThymianPluginFn<Options & {
+        cwd: string;
+    }>;
+    options?: JSONSchemaType<Options>;
+    name: string;
+    version: string;
+    events?: ThymianPluginEvents;
+    actions?: ThymianPluginActions;
+};
+export declare function isPlugin(plugin: unknown): plugin is ThymianPlugin;
+//# sourceMappingURL=thymian-plugin.d.ts.map

package/dist/thymian-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thymian-plugin.d.ts","sourceRoot":"","sources":["../src/thymian-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,MAAM,eAAe,CACzB,OAAO,SAAS,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,IAC5D,CACF,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,EAAE;SACR,IAAI,IAAI,gBAAgB,CAAC,CAAC,EAAE,cAAc,CACzC,IAAI,SAAS,MAAM,aAAa,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,OAAO,CACjE;KACF,CAAC;IACF,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,EAAE;SACR,IAAI,IAAI,iBAAiB,CAAC,CAAC,EAAE;YAC5B,KAAK,EAAE,cAAc,CACnB,IAAI,SAAS,MAAM,cAAc,GAC7B,cAAc,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,GAC7B,OAAO,CACZ,CAAC;YACF,QAAQ,EAAE,cAAc,CACtB,IAAI,SAAS,MAAM,cAAc,GAC7B,cAAc,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,GAChC,OAAO,CACZ,CAAC;SACH;KACF,CAAC;IACF,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,aAAa,CACvB,OAAO,SAAS,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,IACzE;IACF,MAAM,EAAE,eAAe,CAAC,OAAO,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,OAAO,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,aAAa,CAyBjE"}

package/dist/thymian-plugin.js

@@ -0,0 +1,24 @@
+import { ThymianEmitter } from './emitter/index.js';
+import { isRecord } from './utils.js';
+export function isPlugin(plugin) {
+    if (!isRecord(plugin)) {
+        return false;
+    }
+    const requiredKeys = ['plugin', 'name', 'version'];
+    for (const key of requiredKeys) {
+        if (!Object.hasOwn(plugin, key)) {
+            return false;
+        }
+    }
+    if (typeof plugin['plugin'] !== 'function') {
+        return false;
+    }
+    if (typeof plugin['name'] !== 'string') {
+        return false;
+    }
+    if (typeof plugin['version'] !== 'string') {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=thymian-plugin.js.map

package/dist/thymian-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thymian-plugin.js","sourceRoot":"","sources":["../src/thymian-plugin.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAmDtC,MAAM,UAAU,QAAQ,CAAC,MAAe;IACtC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IACnD,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,UAAU,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/thymian.d.ts

@@ -0,0 +1,85 @@
+import type { CoreFormatLoadInput, CoreRequestDispatchInput, CoreRequestSampleInput, CoreTrafficLoadInput, SpecificationInput, TrafficInput, WorkflowOutcome } from './actions/index.js';
+import { ThymianEmitter } from './emitter/index.js';
+import { ThymianFormat } from './format/index.js';
+import type { HttpRequestTemplate, HttpResponse } from './http.js';
+import type { LogLevel } from './logger/log-level.js';
+import type { Logger } from './logger/logger.js';
+import { type ReportSortMode } from './report-sorter.js';
+import { type LoadedTraffic, type RuleFilter, type RulesConfiguration } from './rules/index.js';
+import { ThymianBaseError } from './thymian.error.js';
+import type { ThymianPlugin } from './thymian-plugin.js';
+export interface LintWorkflowInput {
+    specification: SpecificationInput[];
+    rules?: string[];
+    rulesConfig?: RulesConfiguration;
+    ruleFilter?: RuleFilter;
+    options?: Record<string, unknown>;
+}
+export interface TestWorkflowInput {
+    specification: SpecificationInput[];
+    rules?: string[];
+    rulesConfig?: RulesConfiguration;
+    ruleFilter?: RuleFilter;
+    options?: Record<string, unknown>;
+    targetUrl?: string;
+}
+export interface AnalyzeWorkflowInput {
+    specification?: SpecificationInput[];
+    traffic: TrafficInput[];
+    rules?: string[];
+    rulesConfig?: RulesConfiguration;
+    ruleFilter?: RuleFilter;
+    options?: Record<string, unknown>;
+}
+export type RegisteredPlugin<T extends Record<PropertyKey, unknown> = Record<PropertyKey, unknown>> = {
+    plugin: ThymianPlugin<T>;
+    options: T;
+};
+export declare class PluginRegistrationError extends ThymianBaseError {
+}
+export type ThymianOptions = {
+    timeout: number;
+    idleTimeout: number;
+    traceEvents: boolean;
+    cwd: string;
+    logAllErrors: boolean;
+    logLevel?: LogLevel;
+    sortReportsBy?: ReportSortMode;
+};
+export declare class Thymian {
+    #private;
+    private readonly logger;
+    readonly plugins: RegisteredPlugin[];
+    readonly emitter: ThymianEmitter;
+    readonly options: ThymianOptions;
+    static readonly VERSION: string;
+    static readonly DEFAULT_IDLE_TIMEOUT = 500;
+    static readonly DEFAULT_TIMEOUT = 10000;
+    constructor(logger?: Logger, options?: Partial<ThymianOptions>);
+    register<T extends Record<PropertyKey, unknown>>(plugin: ThymianPlugin<T>, options?: T): this;
+    ready(): Promise<void>;
+    run<T>(fn: (emitter: ThymianEmitter, logger: Logger) => Promise<T> | T): Promise<T>;
+    close(): Promise<void>;
+    loadFormat(input: CoreFormatLoadInput, _options?: {
+        emitFormat?: boolean;
+    }): Promise<ThymianFormat>;
+    loadTraffic(input: CoreTrafficLoadInput): Promise<LoadedTraffic>;
+    /**
+     * Architectural note:
+     * Core owns the public validation entrypoints and input-loading contract.
+     * Plugins own the mode-specific execution semantics behind these entrypoints.
+     * This keeps the consumer-facing API stable while preserving plugin-based extensibility.
+     */
+    lint(input: LintWorkflowInput): Promise<WorkflowOutcome>;
+    test(input: TestWorkflowInput): Promise<WorkflowOutcome>;
+    analyze(input: AnalyzeWorkflowInput): Promise<WorkflowOutcome>;
+    sample(input: CoreRequestSampleInput): Promise<HttpRequestTemplate>;
+    dispatch(input: CoreRequestDispatchInput): Promise<HttpResponse>;
+    private bridgeReports;
+    private classifyResults;
+    private flushReportText;
+    private createReportFromViolations;
+    private loadRegisteredPlugins;
+    private registerPlugin;
+}
+//# sourceMappingURL=thymian.d.ts.map

package/dist/thymian.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thymian.d.ts","sourceRoot":"","sources":["../src/thymian.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EAGZ,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAOpD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,KAAK,cAAc,EAAe,MAAM,oBAAoB,CAAC;AACtE,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,kBAAkB,EAAE,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,kBAAkB,EAAE,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACrC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,gBAAgB,CAC1B,CAAC,SAAS,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,IACnE;IACF,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACzB,OAAO,EAAE,CAAC,CAAC;CACZ,CAAC;AAEF,qBAAa,uBAAwB,SAAQ,gBAAgB;CAAG;AAEhE,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,aAAa,CAAC,EAAE,cAAc,CAAC;CAChC,CAAC;AAEF,qBAAa,OAAO;;IAkBhB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAjBzB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,CAAM;IAE1C,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAIjC,gBAAuB,OAAO,SAAuB;IAGrD,gBAAuB,oBAAoB,OAAO;IAGlD,gBAAuB,eAAe,SAAS;gBAG5B,MAAM,GAAE,MAAyB,EAClD,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM;IA0BvC,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,EAC7C,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,OAAO,CAAC,EAAE,CAAC,GACV,IAAI;IAgCD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB5B,GAAG,CAAC,CAAC,EACH,EAAE,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAC9D,OAAO,CAAC,CAAC,CAAC;IAkDP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,UAAU,CACd,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,GAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO,GACtC,OAAO,CAAC,aAAa,CAAC;IAoCnB,WAAW,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IAyBtE;;;;;OAKG;IACG,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAgCxD,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IA6BxD,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAmC9D,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAMnE,QAAQ,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC;IAMtE,OAAO,CAAC,aAAa;IA4BrB,OAAO,CAAC,eAAe;YAYT,eAAe;IAU7B,OAAO,CAAC,0BAA0B;YAuDpB,qBAAqB;YAWrB,cAAc;CAgC7B"}

package/dist/thymian.error.d.ts

@@ -0,0 +1,26 @@
+import { type PartialExceptFor } from './utils.js';
+export type ThymianErrorSeverity = 'info' | 'warn' | 'error';
+export type ThymianErrorOptions = {
+    exitCode: number;
+    suggestions: string[];
+    ref: string;
+    code: string;
+    name: string;
+    severity: ThymianErrorSeverity;
+};
+export interface ThymianError {
+    name: string;
+    message: string;
+    options: PartialExceptFor<ThymianErrorOptions, 'severity'>;
+}
+export declare function isThymianError(value: unknown): value is ThymianError;
+export declare class ThymianBaseError extends Error implements ThymianError {
+    cause?: unknown;
+    readonly options: PartialExceptFor<ThymianErrorOptions, 'severity'>;
+    constructor(message: string, options?: Partial<ThymianErrorOptions> & {
+        cause?: unknown;
+    } & {
+        severity?: ThymianErrorSeverity;
+    });
+}
+//# sourceMappingURL=thymian.error.d.ts.map

package/dist/thymian.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thymian.error.d.ts","sourceRoot":"","sources":["../src/thymian.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE7D,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,oBAAoB,CAAC;CAChC,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,gBAAgB,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;CAC5D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAYpE;AAED,qBAAa,gBAAiB,SAAQ,KAAM,YAAW,YAAY;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC;IAEzB,SAAgB,OAAO,EAAE,gBAAgB,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;gBAEzE,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG;QAC5D,QAAQ,CAAC,EAAE,oBAAoB,CAAC;KAC5B;CAoBT"}

package/dist/thymian.error.js

@@ -0,0 +1,34 @@
+import { isRecord } from './utils.js';
+export function isThymianError(value) {
+    // Check if all the required properties exist and are of proper type
+    return (isRecord(value) &&
+        typeof value?.name === 'string' &&
+        typeof value?.message === 'string' &&
+        ((Object.hasOwn(value, 'options') &&
+            isRecord(value.options) &&
+            (value.options.cause === undefined ||
+                value.options.cause instanceof Error)) ||
+            !Object.hasOwn(value, 'options')));
+}
+export class ThymianBaseError extends Error {
+    cause;
+    options;
+    constructor(message, options = {}) {
+        super(message);
+        if (options.cause) {
+            if (options.cause instanceof Error) {
+                this.cause = options.cause;
+            }
+        }
+        this.options = {
+            severity: 'error',
+            ...options,
+        };
+        this.name =
+            options.name ??
+                (this.constructor.name === 'ThymianBaseError'
+                    ? 'ThymianError'
+                    : this.constructor.name);
+    }
+}
+//# sourceMappingURL=thymian.error.js.map

package/dist/thymian.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thymian.error.js","sourceRoot":"","sources":["../src/thymian.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAyB,MAAM,YAAY,CAAC;AAmB7D,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,oEAAoE;IACpE,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ;QAC/B,OAAO,KAAK,EAAE,OAAO,KAAK,QAAQ;QAClC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC;YAC/B,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;YACvB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS;gBAChC,KAAK,CAAC,OAAO,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC;YACxC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CACpC,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,KAAK,CAAW;IAET,OAAO,CAAoD;IAC3E,YACE,OAAe,EACf,UAEI,EAAE;QAEN,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,OAAO,CAAC,KAAK,YAAY,KAAK,EAAE,CAAC;gBACnC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,OAAO,GAAG;YACb,QAAQ,EAAE,OAAO;YACjB,GAAG,OAAO;SACX,CAAC;QAEF,IAAI,CAAC,IAAI;YACP,OAAO,CAAC,IAAI;gBACZ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,kBAAkB;oBAC3C,CAAC,CAAC,cAAc;oBAChB,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/thymian.js

@@ -0,0 +1,322 @@
+import semver from 'semver';
+import packageJson from '../package.json' with { type: 'json' };
+import { validate } from './ajv.js';
+import { corePlugin } from './core-plugin.js';
+import { ThymianEmitter } from './emitter/index.js';
+import { ThymianFormat } from './format/index.js';
+import { shouldLog } from './logger/log-level.js';
+import { NoopLogger } from './logger/noop.logger.js';
+import { sortReports } from './report-sorter.js';
+import { loadRules, } from './rules/index.js';
+import { resolveViolationLocation } from './rules/rule-runner.js';
+import { ThymianBaseError } from './thymian.error.js';
+import { timeoutPromise } from './utils.js';
+export class PluginRegistrationError extends ThymianBaseError {
+}
+export class Thymian {
+    logger;
+    plugins = [];
+    emitter;
+    options;
+    #ready = false;
+    static VERSION = packageJson.version;
+    // Number of milliseconds that is waited for new events and actions to be emitted before shutting down the emitter.
+    static DEFAULT_IDLE_TIMEOUT = 500;
+    // number of milliseconds that is waited for actions response and plugin registration
+    static DEFAULT_TIMEOUT = 10000;
+    constructor(logger = new NoopLogger(), options = {}) {
+        this.logger = logger;
+        const logLevel = options.logLevel ?? logger.level;
+        const traceEvents = options.traceEvents ?? shouldLog('trace', logLevel);
+        this.options = {
+            idleTimeout: Thymian.DEFAULT_IDLE_TIMEOUT,
+            timeout: Thymian.DEFAULT_TIMEOUT,
+            cwd: process.cwd(),
+            logAllErrors: false,
+            logLevel,
+            ...options,
+            traceEvents,
+        };
+        const emitterLogger = logger.child('@thymian/core');
+        this.emitter = new ThymianEmitter(emitterLogger, ThymianEmitter.emptyEmitterState('@thymian/core'), {
+            traceEvents: this.options.traceEvents,
+            timeout: this.options.timeout,
+        });
+    }
+    register(plugin, options) {
+        // we only consider stable versions for compatibility checks, so that pre-releases
+        // like 1.0.0-beta.1 are also compatible with 1.0.0
+        const thymianStableVersion = Thymian.VERSION.replace(/-.*$/, '');
+        if (!semver.satisfies(thymianStableVersion, plugin.version)) {
+            throw new PluginRegistrationError(`@thymian/core version ${thymianStableVersion} does not match plugin version constraints ${plugin.version} from plugin "${plugin.name}".`, {
+                suggestions: [
+                    `Install the matching plugin version for thymian version ${thymianStableVersion}.`,
+                ],
+            });
+        }
+        if (plugin.options && options) {
+            const validOptions = validate(plugin.options, options);
+            if (!validOptions) {
+                throw new PluginRegistrationError(`Invalid options for plugin "${plugin.name}".`);
+            }
+        }
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-expect-error
+        this.plugins.push({ plugin: plugin, options: options ?? {} });
+        return this;
+    }
+    async ready() {
+        if (this.#ready) {
+            return;
+        }
+        this.logger.info('Loading plugins...');
+        await this.loadRegisteredPlugins();
+        await this.emitter.emitAction('core.ready');
+        this.logger.info(`Thymian ready (${this.plugins.length} plugin(s) loaded).`);
+        this.#ready = true;
+    }
+    run(fn) {
+        return new Promise((resolve, reject) => {
+            let closed = false;
+            const tryCloseThymian = (err) => {
+                if (closed) {
+                    return;
+                }
+                closed = true;
+                this.logger.debug('Try closing Thymian...');
+                this.close()
+                    .then(() => {
+                    this.logger.debug('Thymian closed.');
+                    reject(err);
+                })
+                    .catch((e) => {
+                    this.logger.error('Error while closing Thymian.', e);
+                    reject(err);
+                });
+            };
+            this.emitter.onError((event) => {
+                if (closed && this.options.logAllErrors) {
+                    this.logger
+                        .child(event.source)[event.error.options.severity](event.error.message);
+                }
+                if (event.error.options.severity === 'error') {
+                    tryCloseThymian(event.error);
+                }
+            });
+            (async () => {
+                await this.ready();
+                const result = await fn(this.emitter, this.logger);
+                await this.close();
+                return result;
+            })()
+                .then(resolve)
+                .catch((err) => {
+                tryCloseThymian(err);
+            });
+        });
+    }
+    async close() {
+        await this.emitter.emitAction('core.close');
+        // This let the ThymianEmitter wait 500 ms for the last events to be emitted before shutting down.
+        await this.emitter.shutdown(this.options.idleTimeout);
+        this.emitter.completeSubjects();
+    }
+    async loadFormat(input, _options = {}) {
+        const options = { emitFormat: true, ..._options };
+        this.logger.info(`Loading format from ${input.inputs?.length ?? 0} specification(s)...`);
+        const formats = await this.emitter.emitAction('core.format.load', input, {
+            strategy: 'collect',
+        });
+        const format = formats.length === 0
+            ? new ThymianFormat()
+            : formats
+                .slice(1)
+                .reduce((acc, curr) => acc.merge(ThymianFormat.import(curr)), ThymianFormat.import(formats[0]));
+        this.logger.debug(`Merged Thymian format includes ${format.graph.order} nodes and ${format.graph.size} edges.`);
+        if (options.emitFormat) {
+            await this.emitter.emitAction('core.format', format.export());
+        }
+        if (format.graph.size === 0) {
+            this.logger.warn('No nodes found in Thymian format. Is this intended?');
+        }
+        return format;
+    }
+    async loadTraffic(input) {
+        const loadedTraffic = await this.emitter.emitAction('core.traffic.load', input, {
+            strategy: 'collect',
+        });
+        return loadedTraffic.reduce((acc, current) => ({
+            transactions: [
+                ...(acc.transactions ?? []),
+                ...(current.transactions ?? []),
+            ],
+            traces: [...(acc.traces ?? []), ...(current.traces ?? [])],
+            metadata: {
+                ...(acc.metadata ?? {}),
+                ...(current.metadata ?? {}),
+            },
+        }), {});
+    }
+    /**
+     * Architectural note:
+     * Core owns the public validation entrypoints and input-loading contract.
+     * Plugins own the mode-specific execution semantics behind these entrypoints.
+     * This keeps the consumer-facing API stable while preserving plugin-based extensibility.
+     */
+    async lint(input) {
+        const { rulesConfig, ruleFilter } = input;
+        this.logger.info('Loading specification and rules...');
+        const [format, rules] = await Promise.all([
+            this.loadFormat({ inputs: input.specification }, { emitFormat: false }),
+            loadRules(input.rules ?? [], ruleFilter, rulesConfig, this.options.cwd),
+        ]);
+        this.logger.info(`Loaded ${rules.length} rule(s). Running lint workflow...`);
+        const results = await this.emitter.emitAction('core.lint', { format: format.export(), rules, rulesConfig, options: input.options }, { strategy: 'collect' });
+        this.bridgeReports(results, format);
+        const classification = this.classifyResults(results);
+        this.logger.info(`Lint complete: ${classification}.`);
+        return {
+            classification,
+            text: await this.flushReportText(),
+            results,
+        };
+    }
+    async test(input) {
+        const { rulesConfig, ruleFilter } = input;
+        const [format, rules] = await Promise.all([
+            this.loadFormat({ inputs: input.specification }),
+            loadRules(input.rules ?? [], ruleFilter, rulesConfig, this.options.cwd),
+        ]);
+        const results = await this.emitter.emitAction('core.test', {
+            format: format.export(),
+            rules,
+            rulesConfig,
+            options: input.options,
+            targetUrl: input.targetUrl,
+        }, { strategy: 'collect' });
+        this.bridgeReports(results, format);
+        return {
+            classification: this.classifyResults(results),
+            text: await this.flushReportText(),
+            results,
+        };
+    }
+    async analyze(input) {
+        const { rulesConfig, ruleFilter } = input;
+        const [traffic, rules, format] = await Promise.all([
+            this.loadTraffic({ inputs: input.traffic }),
+            loadRules(input.rules ?? [], ruleFilter, rulesConfig, this.options.cwd),
+            input.specification
+                ? this.loadFormat({ inputs: input.specification }, { emitFormat: false })
+                : Promise.resolve(undefined),
+        ]);
+        const results = await this.emitter.emitAction('core.analyze', {
+            traffic,
+            format: format?.export(),
+            rules,
+            rulesConfig,
+            options: input.options,
+        }, { strategy: 'collect' });
+        this.bridgeReports(results, format ?? new ThymianFormat());
+        return {
+            classification: this.classifyResults(results),
+            text: await this.flushReportText(),
+            results,
+        };
+    }
+    async sample(input) {
+        return this.emitter.emitAction('core.request.sample', input, {
+            strategy: 'first',
+        });
+    }
+    async dispatch(input) {
+        return this.emitter.emitAction('core.request.dispatch', input, {
+            strategy: 'first',
+        });
+    }
+    bridgeReports(results, format) {
+        // Collect all reports first so sorting can operate across them
+        const reports = [];
+        for (const result of results) {
+            if (result.violations.length > 0) {
+                reports.push(this.createReportFromViolations(result.source, result.violations, format, result));
+            }
+        }
+        // Apply sort mode reshaping before emission
+        const sorted = sortReports(reports, this.options.sortReportsBy);
+        for (const report of sorted) {
+            this.emitter.emit('core.report', report);
+        }
+    }
+    classifyResults(results) {
+        if (results.some((result) => result.status === 'error')) {
+            return 'tool-error';
+        }
+        if (results.some((result) => result.status === 'failed')) {
+            return 'findings';
+        }
+        return 'clean-run';
+    }
+    async flushReportText() {
+        const [flushResult] = await this.emitter.emitAction('core.report.flush', undefined, { strategy: 'collect' });
+        return flushResult?.text;
+    }
+    createReportFromViolations(source, violations, format, result) {
+        let message = '';
+        if (result.statistics) {
+            message = `${result.statistics.rulesRun} HTTP rules run successfully. ${result.statistics.rulesWithViolations} rules reported a violation.`;
+        }
+        // Group violations by their resolved location heading
+        const sectionMap = new Map();
+        for (const { ruleName, severity, violation } of violations) {
+            const { heading, location } = resolveViolationLocation(violation, format, ruleName);
+            let section = sectionMap.get(heading);
+            if (!section) {
+                section = { location, items: [] };
+                sectionMap.set(heading, section);
+            }
+            const item = {
+                severity,
+                message: violation.message,
+                ruleName,
+                location,
+            };
+            section.items.push(item);
+        }
+        const sections = [];
+        for (const [heading, { location, items }] of sectionMap) {
+            sections.push({ heading, items, location });
+        }
+        return {
+            source,
+            message,
+            sections,
+            metadata: result.metadata,
+        };
+    }
+    async loadRegisteredPlugins() {
+        await this.registerPlugin({
+            plugin: corePlugin,
+            options: { cwd: this.options.cwd },
+        });
+        for (const plugin of this.plugins) {
+            await this.registerPlugin(plugin);
+        }
+    }
+    async registerPlugin(registeredPlugin) {
+        this.logger.info(`Registering plugin: ${registeredPlugin.plugin.name}`);
+        this.logger.debug(`Register plugin ${registeredPlugin.plugin.name} with options ${JSON.stringify(registeredPlugin.options)}`);
+        this.emitter.emit('core.register', {
+            name: registeredPlugin.plugin.name,
+            events: registeredPlugin.plugin.events ?? {},
+            options: registeredPlugin.options,
+        });
+        await timeoutPromise(registeredPlugin.plugin.plugin(this.emitter.child(registeredPlugin.plugin.name), this.logger.child(registeredPlugin.plugin.name), { ...registeredPlugin.options, cwd: this.options.cwd }), this.options.timeout, new PluginRegistrationError(`Timeout while registering plugin "${registeredPlugin.plugin.name}".`, {
+            suggestions: [
+                'Increase plugin timeout duration. Using the Thymian CLI try using "--timeout" to set custom timeout (default 5000ms).',
+                'Check your plugin registration logic.',
+            ],
+        }));
+    }
+}
+//# sourceMappingURL=thymian.js.map