@cyanheads/eurostat-mcp-server 0.4.0 → 0.5.0

package/dist/mcp-server/tools/definitions/eurostat-search-datasets.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"eurostat-search-datasets.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/eurostat-search-datasets.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAiB,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,6DAA6D,CAAC;AAE1G,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC,0BAA0B,EAAE;IACrE,KAAK,EAAE,0BAA0B;IACjC,WAAW,EACT,4TAA4T;IAC9T,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAC9E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,KAAK,CAAC,IAAI,EAAE,6DAA6D,CAAC;aAC1E,QAAQ,CACP,sVAAsV,CACvV;QACH,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,GAAG,CAAC;aACR,OAAO,CAAC,EAAE,CAAC;aACX,QAAQ,CACP,qMAAqM,CACtM;QACH,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,iaAAia,CACla;KACJ,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,QAAQ,EAAE,CAAC;aACR,KAAK,CACJ,CAAC;aACE,MAAM,CAAC;YACN,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CACP,uGAAuG,CACxG;YACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;YAC3D,IAAI,EAAE,CAAC;iBACJ,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;iBAC1B,QAAQ,CACP,6EAA6E,CAC9E;YACH,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,uFAAuF,CACxF;YACH,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,0FAA0F,CAC3F;YACH,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,2EAA2E,CAC5E;YACH,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,4EAA4E,CAC7E;YACH,SAAS,EAAE,CAAC;iBACT,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,CACP,2OAA2O,CAC5O;SACJ,CAAC;aACD,QAAQ,CAAC,0BAA0B,CAAC,CACxC;aACA,QAAQ,CAAC,oEAAoE,CAAC;QACjF,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,+FAA+F,CAChG;KACJ,CAAC;IACF,UAAU,EAAE;QACV,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QACxD,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,CACP,0FAA0F,CAC3F;QACH,SAAS,EAAE,CAAC;aACT,OAAO,EAAE;aACT,QAAQ,CACP,2FAA2F,CAC5F;QACH,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,kKAAkK,CACnK;KACJ;IAED,MAAM,EAAE;QACN;YACE,MAAM,EAAE,UAAU;YAClB,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,uCAAuC;YAC7C,QAAQ,EACN,2GAA2G;SAC9G;QACD;YACE,MAAM,EAAE,gBAAgB;YACxB,IAAI,EAAE,gBAAgB,CAAC,aAAa;YACpC,IAAI,EAAE,mHAAmH;YACzH,QAAQ,EACN,uFAAuF;SAC1F;KACF;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,GAAG,GAAG,2BAA2B,EAAE,CAAC;QAC1C,IAAI,KAA6C,CAAC;QAClD,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACxE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAAgB,CAAC,IAAI,EAAE,MAAM,KAAK,gBAAgB,EAAE,CAAC;gBACxD,MAAM,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAG,GAAa,CAAC,OAAO,EAAE;oBACvD,QAAQ,EAAE;wBACR,IAAI,EAAE,0BAA0B,KAAK,CAAC,KAAK,gEAAgE;qBAC5G;iBACF,CAAC,CAAC;YACL,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;QAErD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,wBAAwB,KAAK,CAAC,KAAK,IAAI,EAAE;gBAClE,QAAQ,EAAE;oBACR,IAAI,EAAE,yFAAyF;iBAChG;aACF,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,KAAK,SAAS,CAAC;QACzC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,yBAAyB,EAAE;YACtC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,YAAY;YACZ,QAAQ,EAAE,QAAQ,CAAC,MAAM;YACzB,OAAO;SACR,CAAC,CAAC;QACH,GAAG,CAAC,MAAM,CAAC;YACT,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,YAAY;YACZ,SAAS,EAAE,OAAO;YAClB,GAAG,CAAC,OAAO,IAAI,EAAE,UAAU,EAAE,CAAC;SAC/B,CAAC,CAAC;QACH,OAAO;YACL,QAAQ;YACR,QAAQ,EAAE,qHAAqH;SAChI,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAa;YACtB,aAAa,MAAM,CAAC,QAAQ,CAAC,MAAM,UAAU,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM;SAC3F,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,gBAAgB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACxD,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBAC7B,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,SAAS,IAAI,GAAG,MAAM,CAAC,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC;YACxE,CAAC;YACD,IAAI,CAAC,CAAC,QAAQ,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;YACvF,IAAI,CAAC,CAAC,WAAW;gBAAE,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YACpE,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACvE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"eurostat-search-datasets.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/eurostat-search-datasets.tool.ts"],"names":[],"mappings":"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"}

package/dist/services/canvas-accessor.d.ts

@@ -13,6 +13,11 @@ export declare function setCanvas(canvas: DataCanvas | undefined): void;
  * the server is a supported configuration with and without one.
  */
 export declare function getCanvas(): DataCanvas | undefined;
+/**
+ * A fresh handle for one staged table. Distinct per call — every staging call is
+ * its own result set, and a reused name would replace the previous table.
+ */
+export declare function newTableName(): string;
 /**
  * Acquire a canvas, translating a scratch-directory permission failure into an
  * error that names the variable to change.

package/dist/services/canvas-accessor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canvas-accessor.d.ts","sourceRoot":"","sources":["../../src/services/canvas-accessor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAKhF,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,UAAU,GAAG,SAAS,CAElD;AAoBD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,cAAc,CAAC,CAYzB"}
+{"version":3,"file":"canvas-accessor.d.ts","sourceRoot":"","sources":["../../src/services/canvas-accessor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAKhF,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,UAAU,GAAG,SAAS,CAElD;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAoBD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,cAAc,CAAC,CAYzB"}

package/dist/services/canvas-accessor.js

@@ -17,6 +17,13 @@ export function setCanvas(canvas) {
 export function getCanvas() {
     return _canvas;
 }
+/**
+ * A fresh handle for one staged table. Distinct per call — every staging call is
+ * its own result set, and a reused name would replace the previous table.
+ */
+export function newTableName() {
+    return `df_${globalThis.crypto.randomUUID().slice(0, 8)}`;
+}
 /**
  * Errno codes meaning the configured scratch root cannot be written to.
  *

package/dist/services/canvas-accessor.js.map

@@ -1 +1 @@
-{"version":3,"file":"canvas-accessor.js","sourceRoot":"","sources":["../../src/services/canvas-accessor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,IAAI,OAA+B,CAAC;AAEpC,kFAAkF;AAClF,MAAM,UAAU,SAAS,CAAC,MAA8B;IACtD,OAAO,GAAG,MAAM,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE1E,6EAA6E;AAC7E,SAAS,OAAO,CAAC,GAAY;IAC3B,KAAK,IAAI,GAAG,GAAG,GAAG,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,YAAY,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QAC1E,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;QACjD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACzE,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC;IAClB,CAAC;IACD,OAAO;AACT,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAkB,EAClB,QAA4B,EAC5B,GAAY;IAEZ,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK;YAAE,MAAM,GAAG,CAAC;QACtB,MAAM,kBAAkB,CACtB,sDAAsD,KAAK,gJAAgJ,EAC3M,EAAE,MAAM,EAAE,oBAAoB,EAAE,KAAK,EAAE,EACvC,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAClD,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"canvas-accessor.js","sourceRoot":"","sources":["../../src/services/canvas-accessor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,IAAI,OAA+B,CAAC;AAEpC,kFAAkF;AAClF,MAAM,UAAU,SAAS,CAAC,MAA8B;IACtD,OAAO,GAAG,MAAM,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,MAAM,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE1E,6EAA6E;AAC7E,SAAS,OAAO,CAAC,GAAY;IAC3B,KAAK,IAAI,GAAG,GAAG,GAAG,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,YAAY,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QAC1E,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;QACjD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACzE,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC;IAClB,CAAC;IACD,OAAO;AACT,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAkB,EAClB,QAA4B,EAC5B,GAAY;IAEZ,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK;YAAE,MAAM,GAAG,CAAC;QACtB,MAAM,kBAAkB,CACtB,sDAAsD,KAAK,gJAAgJ,EAC3M,EAAE,MAAM,EAAE,oBAAoB,EAAE,KAAK,EAAE,EACvC,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAClD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/services/eurostat-bulk/eurostat-bulk-service.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @fileoverview Eurostat Bulk Service — streaming client for the SDMX 2.1 TSV
+ * dissemination endpoint. Builds the positional dimension key, sniffs gzip off
+ * the stream, enforces a byte budget mid-transfer, classifies XML SOAP faults
+ * and the asynchronous queue envelope, and expands the wide TSV layout into
+ * one row per observation.
+ * @module services/eurostat-bulk/eurostat-bulk-service
+ */
+import type { Context } from '@cyanheads/mcp-ts-core';
+import type { ColumnSchema } from '@cyanheads/mcp-ts-core/canvas';
+import type { AppConfig } from '@cyanheads/mcp-ts-core/config';
+import type { StorageService } from '@cyanheads/mcp-ts-core/storage';
+import { type BulkDownload, type TsvHeader } from './types.js';
+/**
+ * Translate an XML body from the SDMX endpoint into the declared error contract.
+ *
+ * Two unrelated shapes arrive as XML and neither is data. A `S:Fault` envelope
+ * accompanies a 4xx and names the problem in a numeric `faultcode`. The
+ * `syncResponse` envelope arrives on **HTTP 200** carrying a queue ticket
+ * instead of the dataset — parsed as TSV it yields a header row of XML, so it is
+ * detected here rather than downstream.
+ *
+ * Always throws.
+ */
+export declare function classifyXmlBody(xml: string, datasetCode: string): never;
+/**
+ * Split one wide-TSV cell into its value and flags.
+ *
+ * The grammar, read off live responses, is `<value>` `SPACE` `<flags>`, where
+ * flags is `<obs_flag>` optionally followed by `@<conf_status>` and either part
+ * may be empty: `429634.3 `, `3853937.0 p`, `: `, `: @C`. A cell that is empty
+ * on both sides of the split is not an observation at all and yields
+ * `undefined` — distinct from `: `, which is an observation Eurostat reports as
+ * unavailable.
+ */
+export declare function parseCell(cell: string): {
+    conf: string | null;
+    flag: string | null;
+    value: number | null;
+} | undefined;
+/**
+ * Parse the header line of a wide TSV body.
+ *
+ * The first tab-separated field is the comma-joined dimension list with
+ * `\TIME_PERIOD` appended to the last name; the remaining fields are the period
+ * codes, each padded with a trailing space Eurostat does not strip.
+ */
+export declare function parseHeader(line: string): TsvHeader;
+/**
+ * Build the positional dimension key the SDMX path takes.
+ *
+ * The key is a dot-separated segment carrying one position per dimension **in
+ * dataset order excluding time**; empty means wildcard and `+` means OR. The
+ * count must match exactly — a key with one position too few or too many is
+ * rejected upstream with faultcode 140 — so positions are emitted for every
+ * dimension in `dimensionOrder`, filtered or not, and never only for the
+ * dimensions the caller named.
+ *
+ * Returns `undefined` when no filter applies. An all-wildcard key is accepted
+ * by Eurostat, but omitting the segment asks the same question without staking
+ * the request on this server's copy of the dimension order being current.
+ */
+export declare function buildKeyPath(dimensionOrder: string[], filters: Record<string, string[]>): string | undefined;
+/**
+ * Canvas column schema for {@link BulkRow}, declared rather than sniffed.
+ *
+ * Inference reads only the leading rows, which types an all-integer measure
+ * prefix as `BIGINT` — serialized back out as a string — and types an
+ * all-missing prefix from nulls alone. Every column is nullable: a measure is
+ * routinely unavailable, and flags are the exception rather than the rule.
+ */
+export declare function bulkRowSchema(dimensions: string[]): ColumnSchema[];
+export declare class EurostatBulkService {
+    constructor(_config: AppConfig, _storage: StorageService);
+    private buildUrl;
+    /**
+     * Start a bulk download: issue the request, classify the response, parse the
+     * header, and hand back a generator over the body.
+     *
+     * The request is made once with no retry. A bulk body streams for up to
+     * `EUROSTAT_BULK_TIMEOUT_MS`, so re-running it on a transient failure costs
+     * the caller another full transfer for a request that is already the most
+     * expensive one this server makes; the failure is surfaced instead.
+     */
+    startDownload(datasetCode: string, dimensionOrder: string[], filters: Record<string, string[]>, sinceP: string | undefined, untilP: string | undefined, ctx: Context): Promise<BulkDownload>;
+}
+export declare function initEurostatBulkService(config: AppConfig, storage: StorageService): void;
+export declare function getEurostatBulkService(): EurostatBulkService;
+//# sourceMappingURL=eurostat-bulk-service.d.ts.map

package/dist/services/eurostat-bulk/eurostat-bulk-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eurostat-bulk-service.d.ts","sourceRoot":"","sources":["../../../src/services/eurostat-bulk/eurostat-bulk-service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAO/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE,OAAO,EACL,KAAK,YAAY,EAWjB,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AAmCpB;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,KAAK,CAmCvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,SAAS,CAchF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAkBnD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,cAAc,EAAE,MAAM,EAAE,EACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAChC,MAAM,GAAG,SAAS,CAapB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,CAUlE;AAED,qBAAa,mBAAmB;IAI9B,YAAY,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAI;IAE5D,OAAO,CAAC,QAAQ;IAiBhB;;;;;;;;OAQG;IACG,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EAAE,EACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EACjC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,YAAY,CAAC,CAyDvB;CACF;AA6RD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAExF;AAED,wBAAgB,sBAAsB,IAAI,mBAAmB,CAO5D"}

package/dist/services/eurostat-bulk/eurostat-bulk-service.js

@@ -0,0 +1,501 @@
+/**
+ * @fileoverview Eurostat Bulk Service — streaming client for the SDMX 2.1 TSV
+ * dissemination endpoint. Builds the positional dimension key, sniffs gzip off
+ * the stream, enforces a byte budget mid-transfer, classifies XML SOAP faults
+ * and the asynchronous queue envelope, and expands the wide TSV layout into
+ * one row per observation.
+ * @module services/eurostat-bulk/eurostat-bulk-service
+ */
+import { notFound, serviceUnavailable, validationError, } from '@cyanheads/mcp-ts-core/errors';
+import { fetchWithTimeout } from '@cyanheads/mcp-ts-core/utils';
+import { getServerConfig } from '../../config/server-config.js';
+import { CONF_STATUS_COLUMN, CONF_STATUS_LABEL_COLUMN, CONF_STATUS_LABELS, OBS_FLAG_COLUMN, OBS_FLAG_LABEL_COLUMN, OBS_FLAG_LABELS, OBS_VALUE_COLUMN, TIME_COLUMN, } from './types.js';
+// Context satisfies the runtime contract of RequestContext but lacks the index signature
+// required by fetchWithTimeout.
+const asReqCtx = (ctx) => ctx;
+/**
+ * Decoded characters buffered before an XML body is classified.
+ *
+ * Both non-data shapes are small — the largest SOAP fault observed is under 400
+ * bytes and the queue envelope under 350 — so this only has to hold one of them.
+ * It deliberately does **not** bound the search for the TSV header's line break:
+ * that line carries one field per period and runs to 166 KB on a daily series.
+ */
+const XML_PEEK_CHARS = 8_192;
+/** Separator between the observation flag and the confidentiality flag inside a TSV cell. */
+const CONF_SEPARATOR = '@';
+/** Eurostat's marker for an observation whose value is not available. */
+const MISSING_VALUE = ':';
+/** The header line's first field ends with this literal before the period columns begin. */
+const TIME_HEADER_SUFFIX = '\\TIME_PERIOD';
+/** Minimal XML entity decoding — the five predefined entities SOAP fault strings use. */
+function decodeEntities(text) {
+    return text
+        .replaceAll('&lt;', '<')
+        .replaceAll('&gt;', '>')
+        .replaceAll('&quot;', '"')
+        .replaceAll('&apos;', "'")
+        .replaceAll('&amp;', '&');
+}
+/**
+ * Translate an XML body from the SDMX endpoint into the declared error contract.
+ *
+ * Two unrelated shapes arrive as XML and neither is data. A `S:Fault` envelope
+ * accompanies a 4xx and names the problem in a numeric `faultcode`. The
+ * `syncResponse` envelope arrives on **HTTP 200** carrying a queue ticket
+ * instead of the dataset — parsed as TSV it yields a header row of XML, so it is
+ * detected here rather than downstream.
+ *
+ * Always throws.
+ */
+export function classifyXmlBody(xml, datasetCode) {
+    if (xml.includes('syncResponse') || xml.includes('<status>SUBMITTED</status>')) {
+        throw serviceUnavailable(`Eurostat queued this extraction instead of returning data: the SDMX endpoint answered with an asynchronous "SUBMITTED" ticket for "${datasetCode}". The queued result is not retrievable through this server. Narrow the request with dimension filters or a period range so Eurostat serves it synchronously.`, { reason: 'async_queued', datasetCode, retryable: false });
+    }
+    const code = /<faultcode>\s*(\d+)\s*<\/faultcode>/.exec(xml)?.[1];
+    const detail = decodeEntities(/<faultstring>([\s\S]*?)<\/faultstring>/.exec(xml)?.[1]?.trim() ?? xml.slice(0, 300));
+    if (code === '100') {
+        throw notFound(`Dataset "${datasetCode}" is not available for dissemination. Eurostat fault ${code}: ${detail}`, { reason: 'not_found', datasetCode, faultcode: code });
+    }
+    if (code === '140') {
+        throw validationError(`Eurostat rejected the dimension key: the number of filter positions did not match the dataset's dimensions. Eurostat fault ${code}: ${detail}`, { reason: 'filter_arity', datasetCode, faultcode: code });
+    }
+    if (code === '150') {
+        throw validationError(`Eurostat rejected a filter value. This fault also covers a period range outside the dataset's coverage. Eurostat fault ${code}: ${detail}`, { reason: 'invalid_dimension', datasetCode, faultcode: code });
+    }
+    throw serviceUnavailable(`Eurostat SDMX endpoint returned a fault for "${datasetCode}"${code ? ` (faultcode ${code})` : ''}: ${detail}`, { reason: 'upstream_fault', datasetCode, ...(code && { faultcode: code }) });
+}
+/**
+ * Split one wide-TSV cell into its value and flags.
+ *
+ * The grammar, read off live responses, is `<value>` `SPACE` `<flags>`, where
+ * flags is `<obs_flag>` optionally followed by `@<conf_status>` and either part
+ * may be empty: `429634.3 `, `3853937.0 p`, `: `, `: @C`. A cell that is empty
+ * on both sides of the split is not an observation at all and yields
+ * `undefined` — distinct from `: `, which is an observation Eurostat reports as
+ * unavailable.
+ */
+export function parseCell(cell) {
+    const sep = cell.indexOf(' ');
+    const rawValue = (sep === -1 ? cell : cell.slice(0, sep)).trim();
+    const rawFlags = (sep === -1 ? '' : cell.slice(sep + 1)).trim();
+    if (rawValue === '' && rawFlags === '')
+        return;
+    const atIdx = rawFlags.indexOf(CONF_SEPARATOR);
+    const flag = (atIdx === -1 ? rawFlags : rawFlags.slice(0, atIdx)) || null;
+    const conf = (atIdx === -1 ? '' : rawFlags.slice(atIdx + 1)) || null;
+    if (rawValue === '' || rawValue === MISSING_VALUE)
+        return { conf, flag, value: null };
+    const num = Number(rawValue);
+    return { conf, flag, value: Number.isFinite(num) ? num : null };
+}
+/**
+ * Parse the header line of a wide TSV body.
+ *
+ * The first tab-separated field is the comma-joined dimension list with
+ * `\TIME_PERIOD` appended to the last name; the remaining fields are the period
+ * codes, each padded with a trailing space Eurostat does not strip.
+ */
+export function parseHeader(line) {
+    const fields = line.split('\t');
+    const keyField = (fields[0] ?? '').trim();
+    const dimensionField = keyField.endsWith(TIME_HEADER_SUFFIX)
+        ? keyField.slice(0, -TIME_HEADER_SUFFIX.length)
+        : keyField;
+    const dimensions = dimensionField
+        .split(',')
+        .map((d) => d.trim())
+        .filter((d) => d !== '');
+    const periods = fields.slice(1).map((p) => p.trim());
+    if (dimensions.length === 0 || periods.length === 0) {
+        throw serviceUnavailable(`Eurostat returned a TSV body whose header names no ${dimensions.length === 0 ? 'dimensions' : 'periods'}. Header: ${line.slice(0, 200)}`, { reason: 'upstream_fault' });
+    }
+    return { dimensions, periods };
+}
+/**
+ * Build the positional dimension key the SDMX path takes.
+ *
+ * The key is a dot-separated segment carrying one position per dimension **in
+ * dataset order excluding time**; empty means wildcard and `+` means OR. The
+ * count must match exactly — a key with one position too few or too many is
+ * rejected upstream with faultcode 140 — so positions are emitted for every
+ * dimension in `dimensionOrder`, filtered or not, and never only for the
+ * dimensions the caller named.
+ *
+ * Returns `undefined` when no filter applies. An all-wildcard key is accepted
+ * by Eurostat, but omitting the segment asks the same question without staking
+ * the request on this server's copy of the dimension order being current.
+ */
+export function buildKeyPath(dimensionOrder, filters) {
+    const applied = Object.entries(filters).filter(([, values]) => values.length > 0);
+    if (applied.length === 0)
+        return;
+    const unknown = applied.map(([dim]) => dim).filter((dim) => !dimensionOrder.includes(dim));
+    if (unknown.length > 0) {
+        throw validationError(`Filter names ${unknown.map((d) => `"${d}"`).join(', ')}, which ${unknown.length === 1 ? 'is not a dimension' : 'are not dimensions'} of this dataset. Filterable dimensions, in key order: ${dimensionOrder.join(', ')}. The time dimension is filtered with since_period/until_period instead.`, { reason: 'invalid_dimension', unknownDimensions: unknown, dimensionOrder });
+    }
+    return dimensionOrder.map((dim) => (filters[dim] ?? []).join('+')).join('.');
+}
+/**
+ * Canvas column schema for {@link BulkRow}, declared rather than sniffed.
+ *
+ * Inference reads only the leading rows, which types an all-integer measure
+ * prefix as `BIGINT` — serialized back out as a string — and types an
+ * all-missing prefix from nulls alone. Every column is nullable: a measure is
+ * routinely unavailable, and flags are the exception rather than the rule.
+ */
+export function bulkRowSchema(dimensions) {
+    return [
+        ...dimensions.map((dim) => ({ name: dim, type: 'VARCHAR', nullable: true })),
+        { name: TIME_COLUMN, type: 'VARCHAR', nullable: true },
+        { name: OBS_VALUE_COLUMN, type: 'DOUBLE', nullable: true },
+        { name: OBS_FLAG_COLUMN, type: 'VARCHAR', nullable: true },
+        { name: OBS_FLAG_LABEL_COLUMN, type: 'VARCHAR', nullable: true },
+        { name: CONF_STATUS_COLUMN, type: 'VARCHAR', nullable: true },
+        { name: CONF_STATUS_LABEL_COLUMN, type: 'VARCHAR', nullable: true },
+    ];
+}
+export class EurostatBulkService {
+    // config and storage accepted to match the standard service init pattern;
+    // this service uses only the Eurostat public API and per-request config.
+    // biome-ignore lint/complexity/noUselessConstructor: standard init pattern
+    constructor(_config, _storage) { }
+    buildUrl(datasetCode, keyPath, sinceP, untilP) {
+        const { baseUrl } = getServerConfig();
+        const path = keyPath
+            ? `${encodeURIComponent(datasetCode)}/${encodeURIComponent(keyPath)}`
+            : encodeURIComponent(datasetCode);
+        const url = new URL(`${baseUrl}/sdmx/2.1/data/${path}`);
+        url.searchParams.set('format', 'TSV');
+        if (sinceP)
+            url.searchParams.set('startPeriod', sinceP);
+        if (untilP)
+            url.searchParams.set('endPeriod', untilP);
+        return url;
+    }
+    /**
+     * Start a bulk download: issue the request, classify the response, parse the
+     * header, and hand back a generator over the body.
+     *
+     * The request is made once with no retry. A bulk body streams for up to
+     * `EUROSTAT_BULK_TIMEOUT_MS`, so re-running it on a transient failure costs
+     * the caller another full transfer for a request that is already the most
+     * expensive one this server makes; the failure is surfaced instead.
+     */
+    async startDownload(datasetCode, dimensionOrder, filters, sinceP, untilP, ctx) {
+        const { bulkTimeoutMs, bulkMaxBytes } = getServerConfig();
+        const keyPath = buildKeyPath(dimensionOrder, filters);
+        const url = this.buildUrl(datasetCode, keyPath, sinceP, untilP);
+        ctx.log.info('Starting SDMX bulk download', {
+            datasetCode,
+            keyPath,
+            sinceP,
+            untilP,
+            maxBytes: bulkMaxBytes,
+        });
+        let response;
+        try {
+            response = await fetchWithTimeout(url.toString(), bulkTimeoutMs, asReqCtx(ctx), {
+                signal: ctx.signal,
+                // 400 (bad filter value or arity) and 404 (unknown dataset) are modeled outcomes
+                // reclassified below into the declared error contract, not service failures.
+                expectedStatuses: [400, 404],
+            });
+        }
+        catch (err) {
+            // fetchWithTimeout throws for any non-2xx before the caller sees the body, so the
+            // SOAP fault is only reachable through the captured excerpt on err.data. Faults run
+            // well under the framework's 500-byte cap, so the excerpt carries the whole envelope.
+            const body = err.data;
+            if (typeof body?.body === 'string' && body.body.includes('<')) {
+                classifyXmlBody(body.body, datasetCode);
+            }
+            throw err;
+        }
+        if (!response.body) {
+            throw serviceUnavailable(`Eurostat SDMX endpoint returned an empty body for "${datasetCode}".`, { reason: 'upstream_fault', datasetCode });
+        }
+        const stats = {
+            bytesRead: 0,
+            budgetExceeded: false,
+            compressed: false,
+            rowCount: 0,
+            missingCount: 0,
+            periodsSeen: [],
+        };
+        const decoded = await decodeBody(response.body, stats, bulkMaxBytes);
+        const { header, remainder, iterator } = await readHeader(decoded, datasetCode);
+        return {
+            header,
+            stats,
+            url: url.toString(),
+            rows: () => expandRows(iterator, remainder, header, stats),
+        };
+    }
+}
+/**
+ * Wrap the response body in a byte-budgeted, gzip-aware text stream.
+ *
+ * Eurostat compresses large bodies **without** a `Content-Encoding` header — the
+ * only header-level tell is a `.tsv.gz` filename on `Content-Disposition`, and
+ * that is not what is trusted here. The first two bytes are read off the stream
+ * and checked for the gzip magic number, so the decision is made on what
+ * actually arrived. The switch is not monotonic in dataset size, so it cannot
+ * be predicted from the request either.
+ *
+ * The budget counts bytes *after* decompression. That is the uniform measure
+ * across both encodings, and since a gzip body is never larger than what it
+ * expands to, bounding the decoded size bounds the transfer as well. Hitting it
+ * cancels the underlying reader rather than draining the rest — the body is
+ * chunked with no `Content-Length`, so a budget checked after the fact would
+ * have already paid for the whole transfer.
+ */
+async function decodeBody(body, stats, maxBytes) {
+    const reader = body.getReader();
+    // Pull until at least the two magic bytes are in hand; a chunked body can deliver
+    // fewer on the first read, and an empty body delivers none.
+    const prefix = [];
+    let prefixBytes = 0;
+    while (prefixBytes < 2) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        if (value && value.length > 0) {
+            prefix.push(value);
+            prefixBytes += value.length;
+        }
+    }
+    const head = concatChunks(prefix, prefixBytes);
+    stats.compressed = head.length >= 2 && head[0] === 0x1f && head[1] === 0x8b;
+    const replayed = new ReadableStream({
+        start(controller) {
+            if (head.length > 0)
+                controller.enqueue(head);
+        },
+        async pull(controller) {
+            const { done, value } = await reader.read();
+            if (done)
+                controller.close();
+            else
+                controller.enqueue(value);
+        },
+        cancel(reason) {
+            return reader.cancel(reason);
+        },
+    });
+    /**
+     * `DecompressionStream`'s writable side is typed `BufferSource`, wider than the
+     * `Uint8Array` chunks this pipeline carries, so `pipeThrough` will not accept it
+     * directly. The cast narrows the transform to the stream types actually in play
+     * rather than widening the pipeline to `BufferSource`.
+     */
+    const byteStream = stats.compressed
+        ? replayed.pipeThrough(new DecompressionStream('gzip'))
+        : replayed;
+    return budgetedText(byteStream, stats, maxBytes);
+}
+function concatChunks(chunks, total) {
+    if (chunks.length === 1)
+        return chunks[0];
+    const out = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        out.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return out;
+}
+/**
+ * Decode a byte stream to text, stopping the moment the byte budget is spent.
+ *
+ * The generator ends cleanly on overspend rather than throwing: the caller has
+ * already paid for everything downloaded so far, and discarding it would leave
+ * the agent with an error where it could have had a prefix of the dataset plus
+ * `budgetExceeded` telling it exactly what happened.
+ *
+ * Every exit cancels the reader, so nothing further is transferred: overspend,
+ * a normal end, and abandonment alike. Abandonment is the case that needs it —
+ * a staging failure or an abort part-way through the canvas append runs the
+ * `finally`, and releasing the lock alone would leave the response body
+ * undrained and its connection held. Cancelling a stream that already ended is
+ * a no-op.
+ */
+async function* budgetedText(stream, stats, maxBytes) {
+    const reader = stream.getReader();
+    const decoder = new TextDecoder('utf-8');
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            if (!value || value.length === 0)
+                continue;
+            stats.bytesRead += value.length;
+            if (stats.bytesRead > maxBytes) {
+                stats.budgetExceeded = true;
+                return;
+            }
+            const text = decoder.decode(value, { stream: true });
+            if (text)
+                yield text;
+        }
+        const tail = decoder.decode();
+        if (tail)
+            yield tail;
+    }
+    finally {
+        await reader.cancel().catch(() => undefined);
+        reader.releaseLock();
+    }
+}
+/**
+ * Consume enough of the text stream to tell data from XML, then take the header.
+ *
+ * Both non-data shapes announce themselves in the first character, so
+ * classification happens before a single row is parsed — a `syncResponse`
+ * envelope arrives on HTTP 200 and would otherwise be read as a TSV header of
+ * XML followed by no rows, which looks like a successful empty download.
+ *
+ * A body identified as XML is then buffered to the peek window before it is
+ * classified, rather than to the first line break. The XML declaration ends in a
+ * newline, so stopping there would hand the classifier the declaration alone and
+ * lose the `syncResponse` and `faultcode` markers that follow it.
+ *
+ * A TSV header, by contrast, is buffered to its line break with no length bound.
+ * Its length is proportional to the dataset's period count — 166 KB and 13,852
+ * fields on a daily series — so capping the search would parse a prefix of it as
+ * the whole header, silently drop every period column past the cap, and read the
+ * header's own tail as a data line. The byte budget is what bounds this loop.
+ */
+async function readHeader(chunks, datasetCode) {
+    let buf = '';
+    let exhausted = false;
+    const pull = async () => {
+        const next = await chunks.next();
+        if (next.done)
+            exhausted = true;
+        else
+            buf += next.value;
+    };
+    while (buf.trim() === '' && !exhausted)
+        await pull();
+    if (buf.trimStart().startsWith('<')) {
+        while (buf.length < XML_PEEK_CHARS && !exhausted)
+            await pull();
+        classifyXmlBody(buf, datasetCode);
+    }
+    while (!buf.includes('\n') && !exhausted)
+        await pull();
+    const newline = buf.indexOf('\n');
+    if (newline === -1) {
+        if (buf.trim() === '') {
+            throw serviceUnavailable(`Eurostat SDMX endpoint returned an empty body for "${datasetCode}".`, { reason: 'upstream_fault', datasetCode });
+        }
+        // A body that ended without a line break: one header line and no data rows.
+        return { header: parseHeader(stripCr(buf)), iterator: chunks, remainder: '' };
+    }
+    return {
+        header: parseHeader(stripCr(buf.slice(0, newline))),
+        iterator: chunks,
+        remainder: buf.slice(newline + 1),
+    };
+}
+function stripCr(line) {
+    return line.endsWith('\r') ? line.slice(0, -1) : line;
+}
+/**
+ * Expand the wide TSV body into one row per populated cell.
+ *
+ * Each data line carries a comma-joined dimension key and one cell per period
+ * column, so a line becomes as many rows as it has populated cells. Cells that
+ * are blank on both sides of the value/flag split carry no observation and are
+ * skipped; `:` is kept, because Eurostat reporting a value as unavailable is
+ * itself data.
+ *
+ * Only complete lines are parsed. When the byte budget cancels the transfer
+ * mid-line the trailing fragment is dropped rather than parsed into a row with
+ * silently truncated fields.
+ */
+async function* expandRows(chunks, remainder, header, stats) {
+    const seen = new Set();
+    let buf = remainder;
+    const emit = function* (line) {
+        const trimmed = stripCr(line);
+        if (trimmed === '')
+            return;
+        const fields = trimmed.split('\t');
+        const keyParts = (fields[0] ?? '').split(',');
+        const cellCount = Math.min(fields.length - 1, header.periods.length);
+        for (let i = 0; i < cellCount; i++) {
+            const parsed = parseCell(fields[i + 1] ?? '');
+            if (!parsed)
+                continue;
+            const period = header.periods[i] ?? '';
+            const row = {};
+            for (let d = 0; d < header.dimensions.length; d++) {
+                row[header.dimensions[d]] = keyParts[d]?.trim() ?? null;
+            }
+            row[TIME_COLUMN] = period;
+            row[OBS_VALUE_COLUMN] = parsed.value;
+            row[OBS_FLAG_COLUMN] = parsed.flag;
+            row[OBS_FLAG_LABEL_COLUMN] = parsed.flag ? (OBS_FLAG_LABELS[parsed.flag] ?? null) : null;
+            row[CONF_STATUS_COLUMN] = parsed.conf;
+            row[CONF_STATUS_LABEL_COLUMN] = parsed.conf
+                ? (CONF_STATUS_LABELS[parsed.conf] ?? null)
+                : null;
+            stats.rowCount++;
+            if (parsed.value === null)
+                stats.missingCount++;
+            seen.add(period);
+            yield row;
+        }
+    };
+    /**
+     * Drain every complete line sitting in the buffer. Called before the read loop
+     * as well as inside it: a small body arrives whole while the header is being
+     * read, leaving every data line already buffered and no further chunk to
+     * trigger a split.
+     */
+    const flush = function* () {
+        let newline = buf.indexOf('\n');
+        while (newline !== -1) {
+            yield* emit(buf.slice(0, newline));
+            buf = buf.slice(newline + 1);
+            newline = buf.indexOf('\n');
+        }
+    };
+    try {
+        yield* flush();
+        for await (const chunk of chunks) {
+            buf += chunk;
+            yield* flush();
+        }
+        // The final line of a complete body has no trailing newline. A budget-cancelled
+        // body's trailing fragment is not a final line — it is a line cut in half.
+        if (!stats.budgetExceeded)
+            yield* emit(buf);
+        stats.periodsSeen = [...seen].sort();
+    }
+    finally {
+        /**
+         * Close the text stream on every exit. A consumer that stops early — a canvas
+         * append that throws, an abort — abandons this generator, and a small body
+         * whose rows were all buffered while the header was read is abandoned before
+         * the `for await` above ever starts it. Neither path would otherwise reach the
+         * cancel that frees the response body.
+         */
+        await chunks.return(undefined);
+    }
+}
+// --- Init/accessor pattern ---
+let _service;
+export function initEurostatBulkService(config, storage) {
+    _service = new EurostatBulkService(config, storage);
+}
+export function getEurostatBulkService() {
+    if (!_service) {
+        throw new Error('EurostatBulkService not initialized — call initEurostatBulkService() in setup()');
+    }
+    return _service;
+}
+//# sourceMappingURL=eurostat-bulk-service.js.map