@lde/pipeline 0.43.0 → 0.45.0

package/dist/pipelineEvent.d.ts

@@ -0,0 +1,273 @@
+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;
+    /** Where the stage spent its time. Always set by the pipeline; optional so
+     *  code constructing the event need not set it, as is `counts`. */
+    phases?: StagePhases;
+    /** What the stage’s transforms and projection counted, per name, through
+     *  `ReaderContext.count`. */
+    counts?: Readonly<Record<string, number>>;
+}
+/**
+ * The time a stage spent in each of its phases, in milliseconds.
+ *
+ * A stage runs several batches at once, so each phase is added up over all
+ * of them: the phases can together exceed the stage’s `durationMs`, and a
+ * phase that does is one batches spent their time waiting on. Each phase
+ * counts only its own time – a transform waiting on the reader it pulls from
+ * is the reader’s time, not the transform’s.
+ */
+export interface StagePhases {
+    /** Selecting the stage’s items, page by page. */
+    selectMs: number;
+    /** Running the readers’ queries and reading their results. */
+    readMs: number;
+    /** Each attached transform, in the order first attached. A transform
+     *  attached to several readers is one entry, its times added up. */
+    transforms: readonly TransformDuration[];
+    /** Validating the readers’ quads. */
+    validateMs: number;
+    /** Turning batches into the stage’s output items. */
+    projectMs: number;
+    /** The writer’s own work, not counting the time it waited for items. */
+    writeMs: number;
+}
+/** What a completed stage hands back: where its time went, and its counts. */
+export interface StageSummary {
+    phases: StagePhases;
+    counts: Readonly<Record<string, number>>;
+}
+/** One attached transform’s time, in {@link StagePhases.transforms}. */
+export interface TransformDuration {
+    /** The transform function’s name, or `transform N` for one without a name,
+     *  N counting the stage’s transforms from 1. */
+    name: string;
+    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":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAiB,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAGpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAUxC,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAS5B;;GAEG;AACH,qBAAa,YAAY;aACK,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM;CAC5C;AAED,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAE9B;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,CACF,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAEhC;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,qBAAsB,YAAW,MAAM;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAwB;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;gBAEjC,OAAO,EAAE,4BAA4B;IAiBjD;;;;;;;;OAQG;IACG,IAAI,CACR,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IA4C/B;;;;;OAKG;YACW,oBAAoB;IA+BlC;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;;;OAIG;YACW,UAAU;IAmBxB;;;;;OAKG;WACiB,QAAQ,CAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,IAAI,CAAC,4BAA4B,EAAE,OAAO,CAAC,GACpD,OAAO,CAAC,qBAAqB,CAAC;CAIlC;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAErE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,OAAO,CAAC,SAAS,CAAM;IAEd,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI;IAUjE,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI;CAMrC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAuB,gBAAgB,CACrC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,GACzB,aAAa,CAAC,IAAI,CAAC,CASrB"}
+{"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 { StageSummary, UnreadValue } from './pipelineEvent.js';
 /**
  * Transforms a quad stream, given the context of its extension point.
  *
@@ -26,6 +26,13 @@ export interface ReaderContext {
     dataset: Dataset;
     distribution: Distribution;
     stage: string;
+    /**
+     * Add `amount` (1 when left out) to the count called `name`. The pipeline
+     * adds up each name over the stage and reports the totals when it completes
+     * (`stageComplete`’s `counts`) – how many images were fetched and how many
+     * came from a store, say.
+     */
+    count(name: string, amount?: number): void;
 }
 /**
  * The pipeline's one type-changing seam: turn a root-complete batch of quads
@@ -47,7 +54,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;
 }
@@ -177,6 +184,9 @@ export interface RunOptions {
     /** Receives what a {@link BatchTransform} reports through
      *  {@link BatchContext.valueUnread}; dropped when absent. */
     valueUnread?: BatchContext['valueUnread'];
+    /** Receives where the stage spent its time and what it counted, once, when
+     *  it completes. Not called for a stage that is not supported or that fails. */
+    onComplete?: (summary: StageSummary) => void;
 }
 /** Options accepted by {@link ItemSelector.select}. */
 export interface SelectOptions {
@@ -217,12 +227,14 @@ export declare class Stage<Out = Quad> {
     private validateBuffer;
     private readAll;
     /**
-     * Fold a reader's attached transforms over its output stream, in order,
-     * supplying the {@link ReaderContext}. A transform sees one `read()`
-     * call's output (see {@link AttachedReader}); `NotSupported` is handled by
-     * the caller and never reaches a transform.
+     * Run one reader and fold its attached transforms over its output, in order,
+     * supplying the {@link ReaderContext}, each layer timed by `tally`. A
+     * transform sees one `read()` call's output (see {@link AttachedReader});
+     * `NotSupported` is returned as is and never reaches a transform.
      */
-    private applyTransforms;
+    private read;
+    /** Every attached transform’s name, readers in order, for the phase tally. */
+    private get transformNames();
 }
 /** Selects items (as variable bindings) for readers to process. Pagination is an implementation detail. */
 export interface ItemSelector {

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":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAmB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGpE;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,CAAC,GAAG,IAAI,CAC/B,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,EAC1B,OAAO,EAAE,GAAG,KACT,aAAa,CAAC,IAAI,CAAC,CAAC;AAEzB;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,YAAY,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5C;AAED;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,CAAC,GAAG,IAAI,CAChC,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,OAAO,EAAE,YAAY,KAClB,QAAQ,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;AAExC;;;;;GAKG;AACH,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACtC;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CACvE;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC,aAAa,CAAC,EAAE,CAAC;CAC3E;AAED,yEAAyE;AACzE,MAAM,MAAM,YAAY,GACtB,MAAM,GAAG,cAAc,GAAG,CAAC,MAAM,GAAG,cAAc,CAAC,EAAE,CAAC;AAUxD,MAAM,WAAW,YAAY,CAAC,GAAG,GAAG,IAAI;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;IAC9B;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,KAAK,YAAY,CAAC;IAC3E,uDAAuD;IACvD,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB;;;;;;;;;;;;;;;OAeG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mFAAmF;IACnF,UAAU,CAAC,EAAE;QACX,SAAS,EAAE,SAAS,CAAC;QACrB,iEAAiE;QACjE,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;KACvC,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IACtE;;;;;OAKG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;iEAC6D;IAC7D,WAAW,CAAC,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC;IAC1C;oFACgF;IAChF,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;CAC9C;AAED,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,qBAAa,KAAK,CAAC,GAAG,GAAG,IAAI;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAClC,oGAAoG;IACpG,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC;qEACiE;IACjE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAkC;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAiC;gBAEhD,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC;IAmCtC,mDAAmD;IACnD,IAAI,SAAS,IAAI,SAAS,GAAG,SAAS,CAErC;IAEK,GAAG,CACP,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,EAC1B,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAiG/B;;;;OAIG;IACH,OAAO,CAAC,cAAc;YAMR,eAAe;IAyL7B;;;OAGG;YACW,cAAc;YAqBd,OAAO;IA0BrB;;;;;OAKG;YACW,IAAI;IA2BlB,8EAA8E;IAC9E,OAAO,KAAK,cAAc,GAOzB;CACF;AA0DD,2GAA2G;AAC3G,MAAM,WAAW,YAAY;IAC3B,MAAM,CACJ,YAAY,EAAE,YAAY,EAC1B,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,aAAa,CAAC,gBAAgB,CAAC,CAAC;CACpC"}