@lde/pipeline 0.43.0 → 0.44.0

package/dist/pipelineEvent.d.ts

@@ -0,0 +1,231 @@
+import type { Dataset, Distribution } from '@lde/dataset';
+import type { ValidityVerdict } from '@lde/distribution-health';
+import type { ValidationReport } from './validator.js';
+import type { ImportDetails } from './distribution/resolver.js';
+import type { TimeoutTransitionEvent } from './sparql/timeoutPolicy.js';
+/**
+ * Deliberately without `fatal`: the pipeline never ends the process; an
+ * unrecoverable failure rejects {@link Pipeline.run}.
+ */
+export type Level = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Fields every {@link PipelineEvent} carries. Owning the `type` discriminator
+ * here means no event can join the union without one. `defaultLevel` is the
+ * pipeline’s default; reporters may remap it.
+ */
+export interface EventEnvelope<Type extends string> {
+    type: Type;
+    defaultLevel: Level;
+    timestamp: Date;
+    runId: string;
+}
+/** The envelope of every event that belongs to a single dataset. */
+export interface DatasetEventEnvelope<Type extends string> extends EventEnvelope<Type> {
+    dataset: Dataset;
+}
+/** Why something was skipped: a stable `code` to branch on and a human-readable `message`. */
+export interface Reason<Code extends string> {
+    code: Code;
+    message: string;
+}
+/** Why the pipeline skipped a dataset. */
+export type DatasetSkipReason = Reason<'unchanged' | 'probeFailed' | 'resolveFailed' | 'noDistributionAvailable'>;
+/**
+ * Why the pipeline skipped a stage for a dataset: `noItemsSelected` when the
+ * stage’s item selector selected nothing, so the stage does not apply to the
+ * dataset; `notSupported` when it could not run against the dataset’s
+ * distribution.
+ */
+export type StageSkipReason = Reason<'notSupported' | 'noItemsSelected'>;
+/** The outcome of probing one distribution. */
+export interface DistributionAnalysisResult {
+    type: 'sparql' | 'data-dump' | 'network-error';
+    available: boolean;
+    statusCode?: number;
+    error?: string;
+    warnings: string[];
+    /**
+     * The source-change fingerprint observed for this distribution, or `null`
+     * when none could be established (e.g. a live SPARQL endpoint). The shared
+     * key against which a validity verdict's `validatedFingerprint` is matched,
+     * so a consumer can record it on the reachability rail. Always populated by
+     * the pipeline; optional so consumers constructing the result need not set it.
+     */
+    fingerprint?: string | null;
+}
+/**
+ * Items a writer left out of a dataset’s output instead of failing the
+ * dataset – documents a destination refused, say – reported once per
+ * (dataset, target) as the writer finalizes the dataset.
+ */
+export interface ItemsRejected {
+    /** The part of the destination that refused them, e.g. a search index’s
+     *  type name. */
+    readonly target: string;
+    /** Items the dataset wrote to {@link target}, the rejected ones included. */
+    readonly written: number;
+    /** Items left out. */
+    readonly rejected: number;
+    /** Why, most frequent first: each distinct reason, how many items it
+     *  rejected, and the ids of a few of them. Bounded by the writer, so a
+     *  reason that varies per item cannot grow it without limit. */
+    readonly reasons: readonly RejectionReason[];
+}
+/** One reason a writer rejected items, in {@link ItemsRejected.reasons}. */
+export interface RejectionReason {
+    readonly reason: string;
+    readonly count: number;
+    /** Ids of some of the items rejected for this reason. */
+    readonly examples: readonly string[];
+}
+/**
+ * Values a stage read from a dataset but could not interpret – an integer
+ * field over `onbekend`, a date over `Z.j` – and so left out of the items it
+ * produced, reported once per (dataset, target, field) when the dataset
+ * completes. The item itself is still produced; only the value is missing.
+ */
+export interface ValuesUnread {
+    /** The kind of item the values were read for, e.g. a search type’s name. */
+    readonly target: string;
+    /** The field that could not read them; dotted for a nested field. */
+    readonly field: string;
+    /** How many values the field left out. */
+    readonly unread: number;
+    /** A few of them, each a distinct value. Bounded, so a field that rejects
+     *  every value cannot grow the report with the data. */
+    readonly examples: readonly UnreadValue[];
+}
+/** One value a stage could not read, in {@link ValuesUnread.examples}. */
+export interface UnreadValue {
+    /** What the value was read from, as the stage names it – for a search
+     *  document, the node it was projected from, which a publisher can look up
+     *  even where the document is keyed on something else. */
+    readonly id: string;
+    /** The value as the source stated it. */
+    readonly value: string;
+}
+/** The process’s memory use when the event was reported. */
+export interface MemoryUsage {
+    memoryUsageBytes: number;
+    heapUsedBytes: number;
+}
+/** A run started; `name` is the pipeline’s name. */
+export interface PipelineStartEvent extends EventEnvelope<'pipelineStart'> {
+    name: string;
+}
+/** The datasets to process were selected: how many, and how long selecting took. */
+export interface DatasetsSelectedEvent extends EventEnvelope<'datasetsSelected'> {
+    count: number;
+    durationMs: number;
+}
+/**
+ * The run was abandoned because the selection was empty: the writers were told
+ * to abort, so the destination is unchanged.
+ */
+export interface SelectionEmptyEvent extends EventEnvelope<'selectionEmpty'> {
+    message: string;
+}
+/** A run finished. */
+export interface PipelineCompleteEvent extends EventEnvelope<'pipelineComplete'>, MemoryUsage {
+    durationMs: number;
+}
+/** The pipeline started processing a dataset. */
+export type DatasetStartEvent = DatasetEventEnvelope<'datasetStart'>;
+/** One of a dataset’s distributions was probed. */
+export interface DistributionProbedEvent extends DatasetEventEnvelope<'distributionProbed'> {
+    distribution: Distribution;
+    result: DistributionAnalysisResult;
+}
+/** Reported for every distribution the pipeline attempted, even when the dataset is otherwise skipped. */
+export interface DistributionValidatedEvent extends DatasetEventEnvelope<'distributionValidated'> {
+    distribution: Distribution;
+    verdict: ValidityVerdict;
+}
+/** A data dump started importing for a dataset. */
+export type ImportStartedEvent = DatasetEventEnvelope<'importStarted'>;
+/** Importing a distribution failed. */
+export interface ImportFailedEvent extends DatasetEventEnvelope<'importFailed'> {
+    distribution: Distribution;
+    error: Error;
+}
+/** `imported` is set when `distribution` serves an imported data dump. */
+export interface DistributionSelectedEvent extends DatasetEventEnvelope<'distributionSelected'> {
+    distribution: Distribution;
+    imported?: ImportDetails;
+}
+/** A stage started for a dataset. */
+export interface StageStartEvent extends DatasetEventEnvelope<'stageStart'> {
+    stage: string;
+}
+/** A running stage’s progress so far. */
+export interface StageProgressEvent extends DatasetEventEnvelope<'stageProgress'>, MemoryUsage {
+    stage: string;
+    itemsProcessed: number;
+    quadsGenerated: number;
+}
+/** A stage finished for a dataset. */
+export interface StageCompleteEvent extends DatasetEventEnvelope<'stageComplete'> {
+    stage: string;
+    itemsProcessed: number;
+    quadsGenerated: number;
+    durationMs: number;
+}
+/**
+ * Also reported for per-dataset failures outside any stage, with `stage` set
+ * to `write`, `provenance` or `reactive-dump-fallback`.
+ */
+export interface StageFailedEvent extends DatasetEventEnvelope<'stageFailed'> {
+    stage: string;
+    error: Error;
+}
+/** A stage was skipped for a dataset. */
+export interface StageSkippedEvent extends DatasetEventEnvelope<'stageSkipped'> {
+    stage: string;
+    reason: StageSkipReason;
+}
+/**
+ * Reported once per (dataset, validator) pair, even when nothing was validated:
+ * read `quadsValidated` to tell ‘not tested’ from ‘tested and passed’.
+ */
+export interface DatasetValidatedEvent extends DatasetEventEnvelope<'datasetValidated'> {
+    report: ValidationReport;
+}
+/** The pipeline finished processing a dataset. */
+export interface DatasetCompleteEvent extends DatasetEventEnvelope<'datasetComplete'>, MemoryUsage {
+    durationMs: number;
+}
+/** A dataset the pipeline did not process, and why. */
+export interface DatasetSkippedEvent extends DatasetEventEnvelope<'datasetSkipped'> {
+    reason: DatasetSkipReason;
+    /** The error that caused a `probeFailed` or `resolveFailed` skip. */
+    error?: Error;
+}
+/**
+ * Reported when a writer leaves some of a dataset’s items out rather than
+ * failing the dataset, through `RunContext.itemsRejected`.
+ */
+export interface ItemsRejectedEvent extends DatasetEventEnvelope<'itemsRejected'> {
+    rejection: ItemsRejected;
+}
+/**
+ * Reported once per (target, field) that left values out of a dataset’s items
+ * (`BatchContext.valueUnread`), just before `datasetComplete`. Not reported for
+ * a dataset whose stages or write failed: nothing of it is kept, so neither is
+ * what it could not read.
+ */
+export interface ValuesUnreadEvent extends DatasetEventEnvelope<'valuesUnread'> {
+    unread: ValuesUnread;
+}
+/** The adaptive query timeout for an endpoint was tightened. */
+export interface TimeoutTightenedEvent extends DatasetEventEnvelope<'timeoutTightened'>, TimeoutTransitionEvent {
+}
+/** The adaptive query timeout for an endpoint was relaxed. */
+export interface TimeoutRelaxedEvent extends DatasetEventEnvelope<'timeoutRelaxed'>, TimeoutTransitionEvent {
+}
+/** Everything a pipeline run reports, discriminated on `type`. */
+export type PipelineEvent = PipelineStartEvent | DatasetsSelectedEvent | SelectionEmptyEvent | PipelineCompleteEvent | DatasetStartEvent | DistributionProbedEvent | DistributionValidatedEvent | ImportStartedEvent | ImportFailedEvent | DistributionSelectedEvent | StageStartEvent | StageProgressEvent | StageCompleteEvent | StageFailedEvent | StageSkippedEvent | DatasetValidatedEvent | DatasetCompleteEvent | DatasetSkippedEvent | ItemsRejectedEvent | ValuesUnreadEvent | TimeoutTightenedEvent | TimeoutRelaxedEvent;
+/** A {@link PipelineEvent} without the envelope fields the pipeline fills in. */
+export type PipelineEventPayload = PipelineEvent extends infer Event ? Event extends PipelineEvent ? Omit<Event, 'defaultLevel' | 'timestamp' | 'runId'> : never : never;
+/** The pipeline’s default {@link Level} for an event. */
+export declare function levelOf(event: PipelineEventPayload): Level;
+//# sourceMappingURL=pipelineEvent.d.ts.map

package/dist/pipelineEvent.d.ts.map

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

package/dist/pipelineEvent.js

@@ -0,0 +1,35 @@
+/** The pipeline’s default {@link Level} for an event. */
+export function levelOf(event) {
+    switch (event.type) {
+        case 'stageProgress':
+        case 'distributionProbed':
+        case 'importStarted':
+        case 'stageStart':
+            return 'debug';
+        case 'pipelineStart':
+        case 'pipelineComplete':
+        case 'datasetsSelected':
+        case 'datasetStart':
+        case 'datasetComplete':
+        case 'distributionSelected':
+        case 'stageComplete':
+        case 'timeoutRelaxed':
+            return 'info';
+        case 'datasetSkipped':
+            return event.reason.code === 'unchanged' ? 'info' : 'warn';
+        case 'distributionValidated':
+            return event.verdict.valid ? 'info' : 'warn';
+        case 'datasetValidated':
+            return event.report.conforms ? 'info' : 'warn';
+        case 'stageSkipped':
+            return event.reason.code === 'noItemsSelected' ? 'info' : 'warn';
+        case 'selectionEmpty':
+        case 'importFailed':
+        case 'itemsRejected':
+        case 'valuesUnread':
+        case 'timeoutTightened':
+            return 'warn';
+        case 'stageFailed':
+            return 'error';
+    }
+}

package/dist/reporter.d.ts

@@ -0,0 +1,14 @@
+import type { PipelineEvent } from './pipelineEvent.js';
+/**
+ * Observer of a pipeline run. The pipeline hands every {@link PipelineEvent}
+ * to {@link onEvent}, synchronously and in order. Each reporter filters by
+ * level itself.
+ *
+ * A reporter cannot break a run: when {@link onEvent} throws, the pipeline
+ * still hands the event to the other reporters, carries on, and surfaces the
+ * error as a `ReporterWarning` through `process.emitWarning`.
+ */
+export interface Reporter {
+    onEvent(event: PipelineEvent): void;
+}
+//# sourceMappingURL=reporter.d.ts.map

package/dist/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;CACrC"}

package/dist/sparql/reader.d.ts

@@ -10,6 +10,15 @@ export declare class NotSupported {
     readonly message: string;
     constructor(message: string);
 }
+/**
+ * A stage’s item selector selected nothing for the dataset, so the stage does
+ * not apply to it – the usual outcome for a stage that only some datasets
+ * have items for. A {@link NotSupported}, so callers that only check for that
+ * keep treating it as a skip.
+ */
+export declare class NoItemsSelected extends NotSupported {
+    constructor();
+}
 /** A single row of variable bindings (variable name → NamedNode). */
 export type VariableBindings = Record<string, NamedNode>;
 export interface ReadOptions {
@@ -49,7 +58,7 @@ export interface SparqlConstructReaderOptions {
      * Optional custom SparqlEndpointFetcher instance.
      *
      * When supplied, the reader uses this fetcher as-is for every attempt
-     * — the per-attempt timeout from the {@link TimeoutPolicy} is **not**
+     * – the per-attempt timeout from the {@link TimeoutPolicy} is **not**
      * enforced (the supplied fetcher’s own `timeout` governs). Policy
      * `beforeRequest`/`afterRequest` hooks still fire so outcome
      * classification works, but adaptive tightening cannot apply.
@@ -77,7 +86,7 @@ export interface SparqlConstructReaderOptions {
     /**
      * Deduplicate triples in the CONSTRUCT output stream.
      *
-     * SPARQL CONSTRUCT queries can produce duplicate triples — for example,
+     * SPARQL CONSTRUCT queries can produce duplicate triples – for example,
      * constant triples (like `?dataset a edm:ProvidedCHO`) are emitted for
      * every solution row. When enabled, a streaming identity filter removes
      * duplicates inline without buffering.
@@ -99,9 +108,9 @@ export interface SparqlConstructReaderOptions {
  * and parsed at {@link read} time after substitution.
  *
  * Template substitution (applied in order):
- * 1. `#subjectFilter#` — replaced with `distribution.subjectFilter` (deferred to read)
- * 2. `FROM <graph>` — set via `withDefaultGraph` if the distribution has a named graph
- * 3. `?dataset` — replaced with the dataset IRI (string substitution on the serialised query)
+ * 1. `#subjectFilter#` – replaced with `distribution.subjectFilter` (deferred to read)
+ * 2. `FROM <graph>` – set via `withDefaultGraph` if the distribution has a named graph
+ * 3. `?dataset` – replaced with the dataset IRI (string substitution on the serialised query)
  *
  * @example
  * ```typescript
@@ -178,8 +187,8 @@ export declare function readQueryFile(filename: string): Promise<string>;
  * **Why this exists:** `fetch-sparql-endpoint` pipes the raw HTTP response
  * stream directly into N3.js's `StreamParser`. N3.js has a bug
  * ({@link https://github.com/rdfjs/N3.js/issues/578 | N3.js#578}) where
- * tokens that straddle chunk boundaries — most commonly language tags like
- * `@nl-nl` — cause spurious `Unexpected "-nl"` parse errors. The error is
+ * tokens that straddle chunk boundaries – most commonly language tags like
+ * `@nl-nl` – cause spurious `Unexpected "-nl"` parse errors. The error is
  * non-deterministic and typically surfaces only on responses larger than
  * ~12 MB, because that is when HTTP chunking starts splitting mid-token.
  *

package/dist/sparql/reader.d.ts.map

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

package/dist/sparql/reader.js

@@ -27,6 +27,17 @@ export class NotSupported {
         this.message = message;
     }
 }
+/**
+ * A stage’s item selector selected nothing for the dataset, so the stage does
+ * not apply to it – the usual outcome for a stage that only some datasets
+ * have items for. A {@link NotSupported}, so callers that only check for that
+ * keep treating it as a skip.
+ */
+export class NoItemsSelected extends NotSupported {
+    constructor() {
+        super('No items selected');
+    }
+}
 /**
  * A streaming SPARQL CONSTRUCT reader.
  *
@@ -35,9 +46,9 @@ export class NotSupported {
  * and parsed at {@link read} time after substitution.
  *
  * Template substitution (applied in order):
- * 1. `#subjectFilter#` — replaced with `distribution.subjectFilter` (deferred to read)
- * 2. `FROM <graph>` — set via `withDefaultGraph` if the distribution has a named graph
- * 3. `?dataset` — replaced with the dataset IRI (string substitution on the serialised query)
+ * 1. `#subjectFilter#` – replaced with `distribution.subjectFilter` (deferred to read)
+ * 2. `FROM <graph>` – set via `withDefaultGraph` if the distribution has a named graph
+ * 3. `?dataset` – replaced with the dataset IRI (string substitution on the serialised query)
  *
  * @example
  * ```typescript
@@ -196,8 +207,8 @@ export async function readQueryFile(filename) {
  * **Why this exists:** `fetch-sparql-endpoint` pipes the raw HTTP response
  * stream directly into N3.js's `StreamParser`. N3.js has a bug
  * ({@link https://github.com/rdfjs/N3.js/issues/578 | N3.js#578}) where
- * tokens that straddle chunk boundaries — most commonly language tags like
- * `@nl-nl` — cause spurious `Unexpected "-nl"` parse errors. The error is
+ * tokens that straddle chunk boundaries – most commonly language tags like
+ * `@nl-nl` – cause spurious `Unexpected "-nl"` parse errors. The error is
  * non-deterministic and typically surfaces only on responses larger than
  * ~12 MB, because that is when HTTP chunking starts splitting mid-token.
  *

package/dist/stage.d.ts

@@ -5,7 +5,7 @@ import { NotSupported } from './sparql/reader.js';
 import type { TimeoutPolicy } from './sparql/timeoutPolicy.js';
 import type { Validator } from './validator.js';
 import type { DatasetWriter } from './writer/writer.js';
-import type { UnreadValue } from './progressReporter.js';
+import type { UnreadValue } from './pipelineEvent.js';
 /**
  * Transforms a quad stream, given the context of its extension point.
  *
@@ -47,7 +47,7 @@ export interface BatchContext extends ReaderContext {
      * Report a value the transform could not read and so left out of the item
      * it produced – an integer field over `onbekend`, say. The pipeline tallies
      * them per (`target`, `field`) and reports them when the dataset completes
-     * ({@link ProgressReporter.valuesUnread}).
+     * (the `valuesUnread` event).
      */
     valueUnread(target: string, field: string, unread: UnreadValue): void;
 }

package/dist/stage.d.ts.map

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

package/dist/stage.js

@@ -1,4 +1,4 @@
-import { NotSupported } from './sparql/reader.js';
+import { NoItemsSelected, NotSupported } from './sparql/reader.js';
 import { batch } from './batch.js';
 import { AsyncQueue } from './asyncQueue.js';
 export class Stage {
@@ -128,7 +128,7 @@ export class Stage {
         const iter = batches[Symbol.asyncIterator]();
         const first = await iter.next();
         if (first.done) {
-            return new NotSupported('No items selected');
+            return new NoItemsSelected();
         }
         // Reconstruct a full iterable including the peeked first batch.
         const allBatches = (async function* () {

package/dist/unreadValueTally.d.ts

@@ -1,7 +1,7 @@
-import type { UnreadValue, ValuesUnread } from './progressReporter.js';
+import type { UnreadValue, ValuesUnread } from './pipelineEvent.js';
 /**
  * The values a dataset’s stages could not read, tallied per (target, field)
- * for {@link ProgressReporter.valuesUnread}. Bounded by the schema, not the
+ * for the `valuesUnread` event. Bounded by the schema, not the
  * data: one entry per field that rejected anything, each holding a count and
  * at most {@link MAX_EXAMPLES} distinct examples.
  *

package/dist/unreadValueTally.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unreadValueTally.d.ts","sourceRoot":"","sources":["../src/unreadValueTally.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAKvE;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAGpB;IAEJ,0DAA0D;IAC1D,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IAiB7D,mEAAmE;IACnE,OAAO,IAAI,SAAS,YAAY,EAAE;CAGnC"}
+{"version":3,"file":"unreadValueTally.d.ts","sourceRoot":"","sources":["../src/unreadValueTally.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKpE;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAGpB;IAEJ,0DAA0D;IAC1D,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IAiB7D,mEAAmE;IACnE,OAAO,IAAI,SAAS,YAAY,EAAE;CAGnC"}

package/dist/unreadValueTally.js

@@ -2,7 +2,7 @@
 const MAX_EXAMPLES = 5;
 /**
  * The values a dataset’s stages could not read, tallied per (target, field)
- * for {@link ProgressReporter.valuesUnread}. Bounded by the schema, not the
+ * for the `valuesUnread` event. Bounded by the schema, not the
  * data: one entry per field that rejected anything, each holding a count and
  * at most {@link MAX_EXAMPLES} distinct examples.
  *

package/dist/writer/writer.d.ts

@@ -1,7 +1,7 @@
 import { Dataset } from '@lde/dataset';
 import type { Quad } from '@rdfjs/types';
 import type { ProvenanceStore } from '../provenance/store.js';
-import type { ItemsRejected } from '../progressReporter.js';
+import type { ItemsRejected } from '../pipelineEvent.js';
 /**
  * Context for one pipeline run, handed to {@link Writer.openRun}.
  */

package/dist/writer/writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/writer/writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,eAAe,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpC;;;;;;;OAOG;IACH,aAAa,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;IACjE;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,IAAI,GAAG,IAAI;IACxC;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS,CAAC,IAAI,GAAG,IAAI,CAAE,SAAQ,aAAa,CAAC,IAAI,CAAC;IACjE;;;;;;;;;;OAUG;IACH,KAAK,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE;;;;;;;;;OASG;IACH,KAAK,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;;;;;;OASG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,MAAM,CAAC,IAAI,GAAG,IAAI;IACjC;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;CACxD"}
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/writer/writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,eAAe,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpC;;;;;;;OAOG;IACH,aAAa,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;IACjE;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,IAAI,GAAG,IAAI;IACxC;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS,CAAC,IAAI,GAAG,IAAI,CAAE,SAAQ,aAAa,CAAC,IAAI,CAAC;IACjE;;;;;;;;;;OAUG;IACH,KAAK,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE;;;;;;;;;OASG;IACH,KAAK,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;;;;;;OASG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,MAAM,CAAC,IAAI,GAAG,IAAI;IACjC;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;CACxD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lde/pipeline",
-  "version": "0.43.0",
+  "version": "0.44.0",
   "repository": {
     "url": "git+https://github.com/ldelements/lde.git",
     "directory": "packages/pipeline"

package/dist/combineReporters.d.ts

@@ -1,16 +0,0 @@
-import type { ProgressReporter } from './progressReporter.js';
-/**
- * Combine several {@link ProgressReporter}s into one that forwards every
- * lifecycle call to each child that implements it. Lets a single run be
- * observed by more than one reporter – e.g. a console reporter alongside a
- * verdict-collecting one.
- *
- * Each method is dispatched to the children in array order; a child that does
- * not implement a given (optional) method is skipped for that call.
- *
- * Internal to the package: not re-exported from `index.ts`. {@link Pipeline}
- * uses it to normalise a `reporter` array into the single reporter its call
- * sites expect, so the broader API need not grow a new public symbol.
- */
-export declare function combineReporters(reporters: readonly ProgressReporter[]): ProgressReporter;
-//# sourceMappingURL=combineReporters.d.ts.map

package/dist/combineReporters.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"combineReporters.d.ts","sourceRoot":"","sources":["../src/combineReporters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAU9D;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,gBAAgB,EAAE,GACrC,gBAAgB,CAiDlB"}

package/dist/combineReporters.js

@@ -1,57 +0,0 @@
-/**
- * Combine several {@link ProgressReporter}s into one that forwards every
- * lifecycle call to each child that implements it. Lets a single run be
- * observed by more than one reporter – e.g. a console reporter alongside a
- * verdict-collecting one.
- *
- * Each method is dispatched to the children in array order; a child that does
- * not implement a given (optional) method is skipped for that call.
- *
- * Internal to the package: not re-exported from `index.ts`. {@link Pipeline}
- * uses it to normalise a `reporter` array into the single reporter its call
- * sites expect, so the broader API need not grow a new public symbol.
- */
-export function combineReporters(reporters) {
-    const forward = (method, ...args) => {
-        for (const reporter of reporters) {
-            // Cast to the concrete signature for `method`: indexing by a generic key
-            // yields a union of method types TS won't call directly, even though the
-            // arguments are correlated.
-            const handler = reporter[method];
-            // Every method is optional; notify only the children that implement it.
-            // Invoke through `call` so a class-based reporter keeps its `this`: a bare
-            // `handler?.(...)` would drop the receiver and break methods that touch
-            // instance state (e.g. ConsoleReporter’s spinner).
-            handler?.call(reporter, ...args);
-        }
-    };
-    // Listing every method explicitly (rather than a Proxy) keeps the forwarding
-    // type-safe: typing the result as `Required<ProgressReporter>` forces a new
-    // entry here whenever the interface grows, so a forgotten method fails to
-    // compile instead of silently going unforwarded.
-    const combined = {
-        pipelineStart: (...args) => forward('pipelineStart', ...args),
-        datasetsSelected: (...args) => forward('datasetsSelected', ...args),
-        selectionEmpty: (...args) => forward('selectionEmpty', ...args),
-        datasetStart: (...args) => forward('datasetStart', ...args),
-        distributionProbed: (...args) => forward('distributionProbed', ...args),
-        importStarted: (...args) => forward('importStarted', ...args),
-        importFailed: (...args) => forward('importFailed', ...args),
-        distributionValidated: (...args) => forward('distributionValidated', ...args),
-        distributionSelected: (...args) => forward('distributionSelected', ...args),
-        stageStart: (...args) => forward('stageStart', ...args),
-        stageProgress: (...args) => forward('stageProgress', ...args),
-        stageComplete: (...args) => forward('stageComplete', ...args),
-        stageFailed: (...args) => forward('stageFailed', ...args),
-        stageSkipped: (...args) => forward('stageSkipped', ...args),
-        datasetValidated: (...args) => forward('datasetValidated', ...args),
-        datasetComplete: (...args) => forward('datasetComplete', ...args),
-        datasetSkipped: (...args) => forward('datasetSkipped', ...args),
-        itemsRejected: (...args) => forward('itemsRejected', ...args),
-        valuesUnread: (...args) => forward('valuesUnread', ...args),
-        pipelineComplete: (...args) => forward('pipelineComplete', ...args),
-        timeoutTightened: (...args) => forward('timeoutTightened', ...args),
-        timeoutRelaxed: (...args) => forward('timeoutRelaxed', ...args),
-    };
-    return combined;
-}