@fin.cx/opendata 4.3.1 → 4.4.0

package/.smartconfig.json

@@ -5,7 +5,7 @@
       "githost": "gitlab.com",
       "gitscope": "fin.cx",
       "gitrepo": "opendata",
-      "description": "Open business and financial data for TypeScript: register lookups on the German register portal (handelsregister.de) without storage, the statutory public holidays of the German federal states, the base rate of § 247 BGB, and stock and crypto prices and fundamentals from several providers.",
+      "description": "Open business and financial data for TypeScript: register lookups on the German register portal (handelsregister.de) without storage, the statutory public holidays of the German federal states, the base rate of § 247 BGB, the German consumer price index with the arithmetic of index clauses, and stock and crypto prices and fundamentals from several providers.",
       "npmPackagename": "@fin.cx/opendata",
       "license": "MIT",
       "projectDomain": "fin.cx",
@@ -27,7 +27,10 @@
         "Feiertage",
         "working days",
         "Basiszinssatz",
-        "base rate"
+        "base rate",
+        "consumer price index",
+        "Verbraucherpreisindex",
+        "index clause"
       ]
     },
     "release": {

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@fin.cx/opendata',
-    version: '4.3.1',
-    description: 'Open business and financial data for TypeScript: register lookups on the German register portal (handelsregister.de) without storage, the statutory public holidays of the German federal states, the base rate of § 247 BGB, and stock and crypto prices and fundamentals from several providers.'
+    version: '4.4.0',
+    description: 'Open business and financial data for TypeScript: register lookups on the German register portal (handelsregister.de) without storage, the statutory public holidays of the German federal states, the base rate of § 247 BGB, the German consumer price index with the arithmetic of index clauses, and stock and crypto prices and fundamentals from several providers.'
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxrQkFBa0I7SUFDeEIsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLG9TQUFvUztDQUNsVCxDQUFBIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxrQkFBa0I7SUFDeEIsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLDBXQUEwVztDQUN4WCxDQUFBIn0=

package/dist_ts/cpi/classes.bundesbankcpiclient.d.ts

@@ -0,0 +1,25 @@
+import type { ICpiAnnualInput, ICpiClientOptions, ICpiMonthlyInput, ICpiReading, ICpiSeries } from './interfaces.js';
+/**
+ * The Verbraucherpreisindex für Deutschland (overall index, unadjusted) of the Statistisches Bundesamt as
+ * the Deutsche Bundesbank republishes it in its time series API (`bundesbankCpiBaseUrl`), monthly and as
+ * annual averages. Each answer names its base, and the values the Bundesbank marks as its own estimate
+ * (the latest month at times) are kept apart from the published ones. Nothing is kept: each answer goes
+ * to the caller with the source note to show and the answer as it arrived.
+ */
+export declare class BundesbankCpiClient {
+    private readonly options;
+    private readonly baseUrl;
+    constructor(options?: ICpiClientOptions);
+    /** The months from `from` to `to`, both included, or to the latest one when `to` is left out. */
+    getMonthly(inputArg: ICpiMonthlyInput): Promise<ICpiSeries>;
+    /** The annual averages from `from` to `to`, both included, or to the latest one when `to` is left out. */
+    getAnnual(inputArg: ICpiAnnualInput): Promise<ICpiSeries>;
+    /**
+     * The published value of one month. A month with only the Bundesbank's estimate, or with nothing yet,
+     * ends in `not_published`, the estimate in the error where there is one.
+     */
+    getMonth(monthArg: string, optionsArg?: {
+        signal?: AbortSignal;
+    }): Promise<ICpiReading>;
+    private getSeries;
+}

package/dist_ts/cpi/classes.bundesbankcpiclient.js

@@ -0,0 +1,250 @@
+import { CpiError } from './classes.cpierror.js';
+import { bundesbankCpiBaseUrl, bundesbankVpiAnnualKey, bundesbankVpiFirstMonth, bundesbankVpiFirstYear, bundesbankVpiMonthlyKey, destatisLicence, } from './constants.js';
+import { parseDecimal } from './decimal.js';
+import { frequencyOf } from './indexmath.js';
+import { getText, timeoutOf } from './request.js';
+/**
+ * The columns of the API's SDMX-CSV answer this client reads. The API leaves out a column that is empty
+ * in every row: `OBS_STATUS` appears only where a value carries a status.
+ */
+const COLUMNS = ['BBK_STD_FREQ', 'TIME_PERIOD', 'OBS_VALUE', 'BBK_DECIMALS', 'BBK_ID', 'BBK_UNIT', 'BBK_TITLE'];
+const STATUS_COLUMN = 'OBS_STATUS';
+/** The key of the overall index for Germany on one base, as the answer names it. */
+const SERIES_KEY = /^BBDP1\.([MA])\.DE\.N\.VPI\.C\.A00000\.I(\d{2})\.A$/u;
+const UNIT = /^(\d{4})=100$/u;
+const FREQUENCY_CODES = { monthly: 'M', annual: 'A' };
+/** What the API's `OBS_STATUS` says about a value; any other flag is not read. */
+const STATUSES = { '': 'final', E: 'estimated' };
+/** One line of semicolon-separated values; a field in double quotes may hold separators and doubled quotes. */
+const splitLine = (lineArg) => {
+    const fields = [];
+    let field = '';
+    let quoted = false;
+    for (let position = 0; position < lineArg.length; position++) {
+        const character = lineArg[position];
+        if (quoted) {
+            if (character === '"' && lineArg[position + 1] === '"') {
+                field += '"';
+                position++;
+            }
+            else if (character === '"') {
+                quoted = false;
+            }
+            else {
+                field += character;
+            }
+        }
+        else if (character === '"' && field === '') {
+            quoted = true;
+        }
+        else if (character === ';') {
+            fields.push(field);
+            field = '';
+        }
+        else {
+            field += character;
+        }
+    }
+    if (quoted) {
+        return undefined;
+    }
+    fields.push(field);
+    return fields;
+};
+/**
+ * The Verbraucherpreisindex für Deutschland (overall index, unadjusted) of the Statistisches Bundesamt as
+ * the Deutsche Bundesbank republishes it in its time series API (`bundesbankCpiBaseUrl`), monthly and as
+ * annual averages. Each answer names its base, and the values the Bundesbank marks as its own estimate
+ * (the latest month at times) are kept apart from the published ones. Nothing is kept: each answer goes
+ * to the caller with the source note to show and the answer as it arrived.
+ */
+export class BundesbankCpiClient {
+    options;
+    baseUrl;
+    constructor(options = {}) {
+        this.options = options;
+        timeoutOf(options);
+        this.baseUrl = (options.baseUrl ?? bundesbankCpiBaseUrl).replace(/\/?$/u, '/');
+    }
+    /** The months from `from` to `to`, both included, or to the latest one when `to` is left out. */
+    async getMonthly(inputArg) {
+        return this.getSeries({ frequency: 'monthly', from: inputArg.from, ...(inputArg.to !== undefined ? { to: inputArg.to } : {}) }, inputArg.signal);
+    }
+    /** The annual averages from `from` to `to`, both included, or to the latest one when `to` is left out. */
+    async getAnnual(inputArg) {
+        return this.getSeries({ frequency: 'annual', from: inputArg.from, ...(inputArg.to !== undefined ? { to: inputArg.to } : {}) }, inputArg.signal);
+    }
+    /**
+     * The published value of one month. A month with only the Bundesbank's estimate, or with nothing yet,
+     * ends in `not_published`, the estimate in the error where there is one.
+     */
+    async getMonth(monthArg, optionsArg = {}) {
+        const series = await this.getSeries({ frequency: 'monthly', from: monthArg, to: monthArg }, optionsArg.signal);
+        const value = series.values[0];
+        if (!value) {
+            const estimate = series.estimates[0];
+            const message = estimate
+                ? `the index for ${monthArg} is not published yet; the Bundesbank gives only its own estimate (${estimate.value}).`
+                : `the index for ${monthArg} is not published yet.`;
+            throw new CpiError('not_published', message, {
+                service: 'bundesbank',
+                httpStatus: series.answer.httpStatus,
+                answer: series.answer,
+                period: monthArg,
+                ...(estimate ? { estimate } : {}),
+            });
+        }
+        return { ...value, source: series.source, answer: series.answer };
+    }
+    async getSeries(rangeArg, signalArg) {
+        checkRange(rangeArg);
+        const key = rangeArg.frequency === 'monthly' ? bundesbankVpiMonthlyKey : bundesbankVpiAnnualKey;
+        const uri = `${this.baseUrl}${key}?startPeriod=${rangeArg.from}${rangeArg.to !== undefined ? `&endPeriod=${rangeArg.to}` : ''}`;
+        const answer = await getText(this.options, uri, signalArg);
+        const refused = (codeArg, messageArg) => new CpiError(codeArg, messageArg, { service: 'bundesbank', httpStatus: answer.httpStatus, answer });
+        if (answer.httpStatus === 404) {
+            throw refused('series_withdrawn', `the Bundesbank has no series ${key}: it answered 404.`);
+        }
+        if (answer.httpStatus === 429) {
+            throw refused('busy', 'the Bundesbank refused the request as one too many (429).');
+        }
+        if (answer.httpStatus >= 500 && answer.httpStatus <= 599) {
+            throw refused('unavailable', `the Bundesbank cannot answer now (${answer.httpStatus}).`);
+        }
+        if (answer.httpStatus !== 200) {
+            throw refused('unexpected_answer', `the Bundesbank answered ${answer.httpStatus}.`);
+        }
+        const read = readAnswer(answer.text, rangeArg, (messageArg) => refused('unexpected_answer', messageArg));
+        if (!read) {
+            throw new CpiError('not_published', `the Bundesbank has no value from ${rangeArg.from}${rangeArg.to !== undefined ? ` to ${rangeArg.to}` : ' on'} yet.`, {
+                service: 'bundesbank',
+                httpStatus: answer.httpStatus,
+                answer,
+                period: rangeArg.from,
+            });
+        }
+        return {
+            index: 'de-vpi',
+            frequency: rangeArg.frequency,
+            base: read.base,
+            baseYear: read.baseYear,
+            values: read.values,
+            estimates: read.estimates,
+            source: sourceNoteOf(read, uri),
+            answer,
+        };
+    }
+}
+/** A range of the series' periods, or the reason it is none. */
+const checkRange = (rangeArg) => {
+    const written = rangeArg.frequency === 'monthly' ? 'YYYY-MM' : 'YYYY';
+    for (const period of [rangeArg.from, rangeArg.to]) {
+        if (period !== undefined && frequencyOf(period) !== rangeArg.frequency) {
+            throw new CpiError('invalid_input', `${JSON.stringify(period)} is no period written ${written}.`);
+        }
+    }
+    if (rangeArg.to !== undefined && rangeArg.to < rangeArg.from) {
+        throw new CpiError('invalid_input', `the range ends (${rangeArg.to}) before it begins (${rangeArg.from}).`);
+    }
+    const first = rangeArg.frequency === 'monthly' ? bundesbankVpiFirstMonth : bundesbankVpiFirstYear;
+    if (rangeArg.from < first) {
+        throw new CpiError('before_first_period', `${rangeArg.from} lies before ${first}, the first period of the series.`, { period: rangeArg.from });
+    }
+};
+/**
+ * The values of an SDMX-CSV answer, or `undefined` where it holds none. An answer is read only where every
+ * row is of the series and the frequency asked for, of one key and one base, inside the range asked for,
+ * once per period, with a value of the digits the answer states and a status this client knows.
+ */
+const readAnswer = (textArg, rangeArg, unreadableArg) => {
+    const lines = textArg.replace(/^/u, '').split(/\r?\n/u).filter((lineArg) => lineArg !== '');
+    const header = lines[0] === undefined ? undefined : splitLine(lines[0]);
+    if (!header || header[0] !== 'DATAFLOW') {
+        throw unreadableArg('the answer is no SDMX-CSV of the Bundesbank.');
+    }
+    const rows = lines.slice(1);
+    if (rows.length === 0) {
+        return undefined;
+    }
+    const missing = COLUMNS.filter((columnArg) => !header.includes(columnArg));
+    if (missing.length > 0) {
+        throw unreadableArg(`the answer has no column ${missing.join(', ')}.`);
+    }
+    const at = (fieldsArg, columnArg) => {
+        const position = header.indexOf(columnArg);
+        return position < 0 ? '' : fieldsArg[position] ?? '';
+    };
+    const values = [];
+    const estimates = [];
+    const periods = new Set();
+    let key;
+    let title = '';
+    let base = '';
+    let baseYear = 0;
+    for (const row of rows) {
+        const fields = splitLine(row);
+        if (!fields || fields.length !== header.length) {
+            throw unreadableArg(`a row is not of the answer's columns: ${row}`);
+        }
+        const rowKey = at(fields, 'BBK_ID');
+        const keyMatch = SERIES_KEY.exec(rowKey);
+        const unitMatch = UNIT.exec(at(fields, 'BBK_UNIT'));
+        const frequencyCode = FREQUENCY_CODES[rangeArg.frequency];
+        if (!keyMatch || keyMatch[1] !== frequencyCode || at(fields, 'BBK_STD_FREQ') !== frequencyCode) {
+            throw unreadableArg(`${JSON.stringify(rowKey)} is not the ${rangeArg.frequency} series of the overall index for Germany.`);
+        }
+        if (!unitMatch || unitMatch[1].slice(2) !== keyMatch[2]) {
+            throw unreadableArg(`${JSON.stringify(at(fields, 'BBK_UNIT'))} is no base of the series ${rowKey}.`);
+        }
+        if (key !== undefined && key !== rowKey) {
+            throw unreadableArg(`the answer holds more than one series or base: ${key} and ${rowKey}.`);
+        }
+        key = rowKey;
+        title = at(fields, 'BBK_TITLE');
+        base = unitMatch[0];
+        baseYear = Number(unitMatch[1]);
+        const period = at(fields, 'TIME_PERIOD');
+        if (frequencyOf(period) !== rangeArg.frequency || period < rangeArg.from || (rangeArg.to !== undefined && period > rangeArg.to)) {
+            throw unreadableArg(`${JSON.stringify(period)} is not a period asked for.`);
+        }
+        if (periods.has(period)) {
+            throw unreadableArg(`${period} is answered twice.`);
+        }
+        periods.add(period);
+        const flag = at(fields, STATUS_COLUMN);
+        if (!Object.hasOwn(STATUSES, flag)) {
+            throw unreadableArg(`${JSON.stringify(flag)} is no status this client knows, for ${period}.`);
+        }
+        const status = STATUSES[flag];
+        const written = at(fields, 'OBS_VALUE');
+        if (written === '' || written === 'NaN') {
+            // a period without a value has no observation
+            continue;
+        }
+        const decimals = Number(at(fields, 'BBK_DECIMALS'));
+        const decimal = parseDecimal(written);
+        if (!Number.isSafeInteger(decimals) || decimals < 0 || decimals > 6 || !decimal || decimal.units <= 0n || decimal.scale > decimals) {
+            throw unreadableArg(`${JSON.stringify(written)} is no index value of ${at(fields, 'BBK_DECIMALS')} decimals, for ${period}.`);
+        }
+        const value = decimal.scale === decimals ? written : `${written}${decimal.scale === 0 ? '.' : ''}${'0'.repeat(decimals - decimal.scale)}`;
+        (status === 'final' ? values : estimates).push({ index: 'de-vpi', period, value, base, status });
+    }
+    if (key === undefined || values.length + estimates.length === 0) {
+        return undefined;
+    }
+    const byPeriod = (leftArg, rightArg) => leftArg.period.localeCompare(rightArg.period);
+    return { values: values.sort(byPeriod), estimates: estimates.sort(byPeriod), base, baseYear, key, title };
+};
+const sourceNoteOf = (readArg, uriArg) => ({
+    source: 'bundesbank',
+    provider: 'Deutsche Bundesbank',
+    dataOrigin: 'Statistisches Bundesamt (Destatis)',
+    title: readArg.title,
+    key: readArg.key,
+    uri: uriArg,
+    licence: destatisLicence.name,
+    licenceUri: destatisLicence.uri,
+    attribution: `Quelle: Deutsche Bundesbank, Zeitreihe ${readArg.key}; Daten: Statistisches Bundesamt (Destatis), ` +
+        `Verbraucherpreisindex für Deutschland, ${readArg.base}; ${destatisLicence.name} (${destatisLicence.uri}); ${uriArg}`,
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5idW5kZXNiYW5rY3BpY2xpZW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvY3BpL2NsYXNzZXMuYnVuZGVzYmFua2NwaWNsaWVudC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFDakQsT0FBTyxFQUNMLG9CQUFvQixFQUNwQixzQkFBc0IsRUFDdEIsdUJBQXVCLEVBQ3ZCLHNCQUFzQixFQUN0Qix1QkFBdUIsRUFDdkIsZUFBZSxHQUNoQixNQUFNLGdCQUFnQixDQUFDO0FBQ3hCLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFDNUMsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBWTdDLE9BQU8sRUFBRSxPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0sY0FBYyxDQUFDO0FBRWxEOzs7R0FHRztBQUNILE1BQU0sT0FBTyxHQUFHLENBQUMsY0FBYyxFQUFFLGFBQWEsRUFBRSxXQUFXLEVBQUUsY0FBYyxFQUFFLFFBQVEsRUFBRSxVQUFVLEVBQUUsV0FBVyxDQUFVLENBQUM7QUFDekgsTUFBTSxhQUFhLEdBQUcsWUFBWSxDQUFDO0FBRW5DLG9GQUFvRjtBQUNwRixNQUFNLFVBQVUsR0FBRyxzREFBc0QsQ0FBQztBQUUxRSxNQUFNLElBQUksR0FBRyxnQkFBZ0IsQ0FBQztBQUU5QixNQUFNLGVBQWUsR0FBNEMsRUFBRSxPQUFPLEVBQUUsR0FBRyxFQUFFLE1BQU0sRUFBRSxHQUFHLEVBQUUsQ0FBQztBQUUvRixrRkFBa0Y7QUFDbEYsTUFBTSxRQUFRLEdBQWtELEVBQUUsRUFBRSxFQUFFLE9BQU8sRUFBRSxDQUFDLEVBQUUsV0FBVyxFQUFFLENBQUM7QUFpQmhHLCtHQUErRztBQUMvRyxNQUFNLFNBQVMsR0FBRyxDQUFDLE9BQWUsRUFBd0IsRUFBRTtJQUMxRCxNQUFNLE1BQU0sR0FBYSxFQUFFLENB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

package/dist_ts/cpi/classes.cpierror.d.ts

@@ -0,0 +1,44 @@
+import type { ICpiServiceAnswer, ICpiValue, TCpiPeriod } from './interfaces.js';
+/**
+ * Why no index value or no result was given:
+ * - `invalid_input`: a period, a value, a percentage or an amount that is not one, or a range that ends
+ *   before it begins;
+ * - `before_first_period`: a period before the first one the series holds;
+ * - `not_published`: no published value for the period yet: nothing at all, or only an estimate
+ *   (`estimate`); a calculation given an estimate refuses it the same way;
+ * - `base_mismatch`: values of different bases, indices or frequencies, which are never compared;
+ * - `series_withdrawn`: the source no longer has the series asked for (HTTP 404), as happens to a
+ *   series key of an old base after the base year changed;
+ * - `busy`: the source refuses for too many requests (HTTP 429);
+ * - `unavailable`: the source cannot answer now (HTTP 5xx);
+ * - `unreachable`: no answer arrived: the name, the connection or TLS failed;
+ * - `timeout`: the answer did not arrive within the client's time;
+ * - `aborted`: the caller's signal ended the request;
+ * - `unexpected_answer`: an answer this client cannot read: another status, a missing column, a value or
+ *   a flag it does not know, a period it did not ask for, or more than one series or base.
+ */
+export type TCpiErrorCode = 'invalid_input' | 'before_first_period' | 'not_published' | 'base_mismatch' | 'series_withdrawn' | 'busy' | 'unavailable' | 'unreachable' | 'timeout' | 'aborted' | 'unexpected_answer';
+export interface ICpiErrorDetails {
+    /** the source asked, where a request was sent */
+    service?: 'bundesbank';
+    /** the HTTP status of the answer, where one arrived */
+    httpStatus?: number;
+    /** the answer as it arrived, where one did */
+    answer?: ICpiServiceAnswer;
+    /** the period the refusal is about */
+    period?: TCpiPeriod;
+    /** the estimate the source gave for that period, where it gave one (`not_published`) */
+    estimate?: ICpiValue;
+}
+/** The typed error of `@fin.cx/opendata/cpi`. */
+export declare class CpiError extends Error {
+    readonly code: TCpiErrorCode;
+    readonly service?: ICpiErrorDetails['service'];
+    readonly httpStatus?: number;
+    readonly answer?: ICpiServiceAnswer;
+    readonly period?: TCpiPeriod;
+    readonly estimate?: ICpiValue;
+    constructor(code: TCpiErrorCode, message: string, detailsArg?: ICpiErrorDetails, options?: {
+        cause?: unknown;
+    });
+}

package/dist_ts/cpi/classes.cpierror.js

@@ -0,0 +1,30 @@
+/** The typed error of `@fin.cx/opendata/cpi`. */
+export class CpiError extends Error {
+    code;
+    service;
+    httpStatus;
+    answer;
+    period;
+    estimate;
+    constructor(code, message, detailsArg = {}, options) {
+        super(message, options);
+        this.name = 'CpiError';
+        this.code = code;
+        if (detailsArg.service !== undefined) {
+            this.service = detailsArg.service;
+        }
+        if (detailsArg.httpStatus !== undefined) {
+            this.httpStatus = detailsArg.httpStatus;
+        }
+        if (detailsArg.answer !== undefined) {
+            this.answer = detailsArg.answer;
+        }
+        if (detailsArg.period !== undefined) {
+            this.period = detailsArg.period;
+        }
+        if (detailsArg.estimate !== undefined) {
+            this.estimate = detailsArg.estimate;
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5jcGllcnJvci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2NwaS9jbGFzc2VzLmNwaWVycm9yLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQThDQSxpREFBaUQ7QUFDakQsTUFBTSxPQUFPLFFBQVMsU0FBUSxLQUFLO0lBQ2pCLElBQUksQ0FBZ0I7SUFDcEIsT0FBTyxDQUErQjtJQUN0QyxVQUFVLENBQVU7SUFDcEIsTUFBTSxDQUFxQjtJQUMzQixNQUFNLENBQWM7SUFDcEIsUUFBUSxDQUFhO0lBRXJDLFlBQVksSUFBbUIsRUFBRSxPQUFlLEVBQUUsYUFBK0IsRUFBRSxFQUFFLE9BQTZCO1FBQ2hILEtBQUssQ0FBQyxPQUFPLEVBQUUsT0FBTyxDQUFDLENBQUM7UUFDeEIsSUFBSSxDQUFDLElBQUksR0FBRyxVQUFVLENBQUM7UUFDdkIsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLENBQUM7UUFDakIsSUFBSSxVQUFVLENBQUMsT0FBTyxLQUFLLFNBQVMsRUFBRSxDQUFDO1lBQ3JDLElBQUksQ0FBQyxPQUFPLEdBQUcsVUFBVSxDQUFDLE9BQU8sQ0FBQztRQUNwQyxDQUFDO1FBQ0QsSUFBSSxVQUFVLENBQUMsVUFBVSxLQUFLLFNBQVMsRUFBRSxDQUFDO1lBQ3hDLElBQUksQ0FBQyxVQUFVLEdBQUcsVUFBVSxDQUFDLFVBQVUsQ0FBQztRQUMxQyxDQUFDO1FBQ0QsSUFBSSxVQUFVLENBQUMsTUFBTSxLQUFLLFNBQVMsRUFBRSxDQUFDO1lBQ3BDLElBQUksQ0FBQyxNQUFNLEdBQUcsVUFBVSxDQUFDLE1BQU0sQ0FBQztRQUNsQyxDQUFDO1FBQ0QsSUFBSSxVQUFVLENBQUMsTUFBTSxLQUFLLFNBQVMsRUFBRSxDQUFDO1lBQ3BDLElBQUksQ0FBQyxNQUFNLEdBQUcsVUFBVSxDQUFDLE1BQU0sQ0FBQztRQUNsQyxDQUFDO1FBQ0QsSUFBSSxVQUFVLENBQUMsUUFBUSxLQUFLLFNBQVMsRUFBRSxDQUFDO1lBQ3RDLElBQUksQ0FBQyxRQUFRLEdBQUcsVUFBVSxDQUFDLFFBQVEsQ0FBQztRQUN0QyxDQUFDO0lBQ0gsQ0FBQztDQUNGIn0=

package/dist_ts/cpi/constants.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The Deutsche Bundesbank's time series API (SDMX REST), dataflow `BBDP1`, where the Bundesbank
+ * republishes the Verbraucherpreisindex für Deutschland of the Statistisches Bundesamt ("Quelle:
+ * Statistisches Bundesamt, Wiesbaden."). Read on 2026-10-05; it answers without registration.
+ */
+export declare const bundesbankCpiBaseUrl = "https://api.statistiken.bundesbank.de/rest/data/BBDP1/";
+/**
+ * The series keys of the overall index for Germany, monthly and annual average, unadjusted. The base
+ * dimension is left open (`..A`): the answer names the current base (`BBDP1.M.DE.N.VPI.C.A00000.I20.A`,
+ * 2020=100), and when the Statistisches Bundesamt changes the base year the Bundesbank withdraws the
+ * key of the old one (the `I15` key of 2015=100 answers 404).
+ */
+export declare const bundesbankVpiMonthlyKey = "M.DE.N.VPI.C.A00000..A";
+export declare const bundesbankVpiAnnualKey = "A.DE.N.VPI.C.A00000..A";
+/** The first month and year of the series (January 1991, the first one the API answers). */
+export declare const bundesbankVpiFirstMonth = "1991-01";
+export declare const bundesbankVpiFirstYear = "1991";
+/** The licence under which the Statistisches Bundesamt publishes its figures. */
+export declare const destatisLicence: {
+    readonly name: "Datenlizenz Deutschland – Namensnennung – Version 2.0";
+    readonly uri: "https://www.govdata.de/dl-de/by-2-0";
+};
+/** How long one request may take by default, the answer included. */
+export declare const defaultCpiTimeoutMs = 30000;

package/dist_ts/cpi/constants.js

@@ -0,0 +1,25 @@
+/**
+ * The Deutsche Bundesbank's time series API (SDMX REST), dataflow `BBDP1`, where the Bundesbank
+ * republishes the Verbraucherpreisindex für Deutschland of the Statistisches Bundesamt ("Quelle:
+ * Statistisches Bundesamt, Wiesbaden."). Read on 2026-10-05; it answers without registration.
+ */
+export const bundesbankCpiBaseUrl = 'https://api.statistiken.bundesbank.de/rest/data/BBDP1/';
+/**
+ * The series keys of the overall index for Germany, monthly and annual average, unadjusted. The base
+ * dimension is left open (`..A`): the answer names the current base (`BBDP1.M.DE.N.VPI.C.A00000.I20.A`,
+ * 2020=100), and when the Statistisches Bundesamt changes the base year the Bundesbank withdraws the
+ * key of the old one (the `I15` key of 2015=100 answers 404).
+ */
+export const bundesbankVpiMonthlyKey = 'M.DE.N.VPI.C.A00000..A';
+export const bundesbankVpiAnnualKey = 'A.DE.N.VPI.C.A00000..A';
+/** The first month and year of the series (January 1991, the first one the API answers). */
+export const bundesbankVpiFirstMonth = '1991-01';
+export const bundesbankVpiFirstYear = '1991';
+/** The licence under which the Statistisches Bundesamt publishes its figures. */
+export const destatisLicence = {
+    name: 'Datenlizenz Deutschland – Namensnennung – Version 2.0',
+    uri: 'https://www.govdata.de/dl-de/by-2-0',
+};
+/** How long one request may take by default, the answer included. */
+export const defaultCpiTimeoutMs = 30_000;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uc3RhbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvY3BpL2NvbnN0YW50cy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7OztHQUlHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sb0JBQW9CLEdBQUcsd0RBQXdELENBQUM7QUFFN0Y7Ozs7O0dBS0c7QUFDSCxNQUFNLENBQUMsTUFBTSx1QkFBdUIsR0FBRyx3QkFBd0IsQ0FBQztBQUNoRSxNQUFNLENBQUMsTUFBTSxzQkFBc0IsR0FBRyx3QkFBd0IsQ0FBQztBQUUvRCw0RkFBNEY7QUFDNUYsTUFBTSxDQUFDLE1BQU0sdUJBQXVCLEdBQUcsU0FBUyxDQUFDO0FBQ2pELE1BQU0sQ0FBQyxNQUFNLHNCQUFzQixHQUFHLE1BQU0sQ0FBQztBQUU3QyxpRkFBaUY7QUFDakYsTUFBTSxDQUFDLE1BQU0sZUFBZSxHQUFHO0lBQzdCLElBQUksRUFBRSx1REFBdUQ7SUFDN0QsR0FBRyxFQUFFLHFDQUFxQztDQUNsQyxDQUFDO0FBRVgscUVBQXFFO0FBQ3JFLE1BQU0sQ0FBQyxNQUFNLG1CQUFtQixHQUFHLE1BQU0sQ0FBQyJ9

package/dist_ts/cpi/decimal.d.ts

@@ -0,0 +1,13 @@
+/** A non-negative decimal as integer units of 10^-scale: `'113.5'` is 1135 at scale 1. */
+export interface IScaledDecimal {
+    units: bigint;
+    scale: number;
+}
+export declare const powerOfTen: (exponentArg: number) => bigint;
+export declare const parseDecimal: (textArg: unknown) => IScaledDecimal | undefined;
+/** The units of a decimal at a scale at least its own. */
+export declare const atScale: (decimalArg: IScaledDecimal, scaleArg: number) => bigint;
+/** numerator / denominator, rounded half away from zero ("kaufmännisch"); the denominator is positive. */
+export declare const divideRounded: (numeratorArg: bigint, denominatorArg: bigint) => bigint;
+/** Units of 10^-scale written as a decimal with exactly `scaleArg` digits after the point: `-22` at 1 is `'-2.2'`. */
+export declare const formatUnits: (unitsArg: bigint, scaleArg: number) => string;

package/dist_ts/cpi/decimal.js

@@ -0,0 +1,33 @@
+/** A decimal written with digits and at most one point between them; no sign, no exponent, no comma, no leading zero. */
+const DECIMAL = /^(0|[1-9]\d*)(?:\.(\d+))?$/u;
+const TEN = 10n;
+export const powerOfTen = (exponentArg) => TEN ** BigInt(exponentArg);
+export const parseDecimal = (textArg) => {
+    const match = typeof textArg === 'string' ? DECIMAL.exec(textArg) : null;
+    if (!match) {
+        return undefined;
+    }
+    const fraction = match[2] ?? '';
+    return { units: BigInt(`${match[1]}${fraction}`), scale: fraction.length };
+};
+/** The units of a decimal at a scale at least its own. */
+export const atScale = (decimalArg, scaleArg) => decimalArg.units * powerOfTen(scaleArg - decimalArg.scale);
+/** numerator / denominator, rounded half away from zero ("kaufmännisch"); the denominator is positive. */
+export const divideRounded = (numeratorArg, denominatorArg) => {
+    const negative = numeratorArg < 0n;
+    const magnitude = negative ? -numeratorArg : numeratorArg;
+    let quotient = magnitude / denominatorArg;
+    if ((magnitude % denominatorArg) * 2n >= denominatorArg) {
+        quotient += 1n;
+    }
+    return negative ? -quotient : quotient;
+};
+/** Units of 10^-scale written as a decimal with exactly `scaleArg` digits after the point: `-22` at 1 is `'-2.2'`. */
+export const formatUnits = (unitsArg, scaleArg) => {
+    const negative = unitsArg < 0n;
+    const digits = (negative ? -unitsArg : unitsArg).toString().padStart(scaleArg + 1, '0');
+    const whole = digits.slice(0, digits.length - scaleArg);
+    const fraction = digits.slice(digits.length - scaleArg);
+    return `${negative ? '-' : ''}${whole}${scaleArg > 0 ? `.${fraction}` : ''}`;
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVjaW1hbC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2NwaS9kZWNpbWFsLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQU1BLHlIQUF5SDtBQUN6SCxNQUFNLE9BQU8sR0FBRyw2QkFBNkIsQ0FBQztBQUU5QyxNQUFNLEdBQUcsR0FBRyxHQUFHLENBQUM7QUFFaEIsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHLENBQUMsV0FBbUIsRUFBVSxFQUFFLENBQUMsR0FBRyxJQUFJLE1BQU0sQ0FBQyxXQUFXLENBQUMsQ0FBQztBQUV0RixNQUFNLENBQUMsTUFBTSxZQUFZLEdBQUcsQ0FBQyxPQUFnQixFQUE4QixFQUFFO0lBQzNFLE1BQU0sS0FBSyxHQUFHLE9BQU8sT0FBTyxLQUFLLFFBQVEsQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDO0lBQ3pFLElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztRQUNYLE9BQU8sU0FBUyxDQUFDO0lBQ25CLENBQUM7SUFDRCxNQUFNLFFBQVEsR0FBRyxLQUFLLENBQUMsQ0FBQyxDQUFDLElBQUksRUFBRSxDQUFDO0lBQ2hDLE9BQU8sRUFBRSxLQUFLLEVBQUUsTUFBTSxDQUFDLEdBQUcsS0FBSyxDQUFDLENBQUMsQ0FBQyxHQUFHLFFBQVEsRUFBRSxDQUFDLEVBQUUsS0FBSyxFQUFFLFFBQVEsQ0FBQyxNQUFNLEVBQUUsQ0FBQztBQUM3RSxDQUFDLENBQUM7QUFFRiwwREFBMEQ7QUFDMUQsTUFBTSxDQUFDLE1BQU0sT0FBTyxHQUFHLENBQUMsVUFBMEIsRUFBRSxRQUFnQixFQUFVLEVBQUUsQ0FDOUUsVUFBVSxDQUFDLEtBQUssR0FBRyxVQUFVLENBQUMsUUFBUSxHQUFHLFVBQVUsQ0FBQyxLQUFLLENBQUMsQ0FBQztBQUU3RCwwR0FBMEc7QUFDMUcsTUFBTSxDQUFDLE1BQU0sYUFBYSxHQUFHLENBQUMsWUFBb0IsRUFBRSxjQUFzQixFQUFVLEVBQUU7SUFDcEYsTUFBTSxRQUFRLEdBQUcsWUFBWSxHQUFHLEVBQUUsQ0FBQztJQUNuQyxNQUFNLFNBQVMsR0FBRyxRQUFRLENBQUMsQ0FBQyxDQUFDLENBQUMsWUFBWSxDQUFDLENBQUMsQ0FBQyxZQUFZLENBQUM7SUFDMUQsSUFBSSxRQUFRLEdBQUcsU0FBUyxHQUFHLGNBQWMsQ0FBQztJQUMxQyxJQUFJLENBQUMsU0FBUyxHQUFHLGNBQWMsQ0FBQyxHQUFHLEVBQUUsSUFBSSxjQUFjLEVBQUUsQ0FBQztRQUN4RCxRQUFRLElBQUksRUFBRSxDQUFDO0lBQ2pCLENBQUM7SUFDRCxPQUFPLFFBQVEsQ0FBQyxDQUFDLENBQUMsQ0FBQyxRQUFRLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBQztBQUN6QyxDQUFDLENBQUM7QUFFRixzSEFBc0g7QUFDdEgsTUFBTSxDQUFDLE1BQU0sV0FBVyxHQUFHLENBQUMsUUFBZ0IsRUFBRSxRQUFnQixFQUFVLEVBQUU7SUFDeEUsTUFBTSxRQUFRLEdBQUcsUUFBUSxHQUFHLEVBQUUsQ0FBQztJQUMvQixNQUFNLE1BQU0sR0FBRyxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUMsQ0FBQyxRQUFRLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxDQUFDLFFBQVEsRUFBRSxDQUFDLFFBQVEsQ0FBQyxRQUFRLEdBQUcsQ0FBQyxFQUFFLEdBQUcsQ0FBQyxDQUFDO0lBQ3hGLE1BQU0sS0FBSyxHQUFHLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQyxFQUFFLE1BQU0sQ0FBQyxNQUFNLEdBQUcsUUFBUSxDQUFDLENBQUM7SUFDeEQsTUFBTSxRQUFRLEdBQUcsTUFBTSxDQUFDLEtBQUssQ0FBQyxNQUFNLENBQUMsTUFBTSxHQUFHLFFBQVEsQ0FBQyxDQUFDO0lBQ3hELE9BQU8sR0FBRyxRQUFRLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsRUFBRSxHQUFHLEtBQUssR0FBRyxRQUFRLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxJQUFJLFFBQVEsRUFBRSxDQUFDLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQztBQUMvRSxDQUFDLENBQUMifQ==

package/dist_ts/cpi/index.d.ts

@@ -0,0 +1,5 @@
+export * from './interfaces.js';
+export { CpiError, type ICpiErrorDetails, type TCpiErrorCode } from './classes.cpierror.js';
+export { bundesbankCpiBaseUrl, bundesbankVpiAnnualKey, bundesbankVpiFirstMonth, bundesbankVpiFirstYear, bundesbankVpiMonthlyKey, defaultCpiTimeoutMs, destatisLicence, } from './constants.js';
+export { cpiChangePercent, cpiChangePoints, cpiFirstReaching, cpiScaleAmount, cpiThresholds } from './indexmath.js';
+export { BundesbankCpiClient } from './classes.bundesbankcpiclient.js';

package/dist_ts/cpi/index.js

@@ -0,0 +1,9 @@
+// This entry point stands alone: it imports nothing from the rest of the package and has no
+// dependencies. It keeps nothing: every answer goes to the caller, with the source's answer as it
+// arrived, which the caller keeps as the evidence of an index adjustment.
+export * from './interfaces.js';
+export { CpiError } from './classes.cpierror.js';
+export { bundesbankCpiBaseUrl, bundesbankVpiAnnualKey, bundesbankVpiFirstMonth, bundesbankVpiFirstYear, bundesbankVpiMonthlyKey, defaultCpiTimeoutMs, destatisLicence, } from './constants.js';
+export { cpiChangePercent, cpiChangePoints, cpiFirstReaching, cpiScaleAmount, cpiThresholds } from './indexmath.js';
+export { BundesbankCpiClient } from './classes.bundesbankcpiclient.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9jcGkvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsNEZBQTRGO0FBQzVGLGtHQUFrRztBQUNsRywwRUFBMEU7QUFDMUUsY0FBYyxpQkFBaUIsQ0FBQztBQUNoQyxPQUFPLEVBQUUsUUFBUSxFQUE2QyxNQUFNLHVCQUF1QixDQUFDO0FBQzVGLE9BQU8sRUFDTCxvQkFBb0IsRUFDcEIsc0JBQXNCLEVBQ3RCLHVCQUF1QixFQUN2QixzQkFBc0IsRUFDdEIsdUJBQXVCLEVBQ3ZCLG1CQUFtQixFQUNuQixlQUFlLEdBQ2hCLE1BQU0sZ0JBQWdCLENBQUM7QUFDeEIsT0FBTyxFQUFFLGdCQUFnQixFQUFFLGVBQWUsRUFBRSxnQkFBZ0IsRUFBRSxjQUFjLEVBQUUsYUFBYSxFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFDcEgsT0FBTyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sa0NBQWtDLENBQUMifQ==

package/dist_ts/cpi/indexmath.d.ts

@@ -0,0 +1,35 @@
+import type { ICpiReachOptions, ICpiScaleOptions, ICpiThresholds, ICpiValue, TCpiFrequency } from './interfaces.js';
+/** The frequency a period is written in, or `undefined` for something that is no period. */
+export declare const frequencyOf: (periodArg: unknown) => TCpiFrequency | undefined;
+/**
+ * The change from one value to another in percent, as the Statistisches Bundesamt computes it:
+ * ((new / old) × 100) − 100, rounded half away from zero to one decimal (`'13.0'`, `'-2.2'`).
+ * It does not depend on the base, but both values must be read on the same one.
+ */
+export declare const cpiChangePercent: (oldArg: ICpiValue, newArg: ICpiValue) => string;
+/**
+ * The change from one value to another in index points (new − old), with the digits of the more
+ * precise value (`'12.2'`, `'-1.0'`). Points depend on the base, so they are only given within one.
+ */
+export declare const cpiChangePoints: (oldArg: ICpiValue, newArg: ICpiValue) => string;
+/**
+ * The thresholds of a percent rule: reference × (1 + percent / 100) and reference × (1 − percent / 100),
+ * rounded half away from zero to the reference value's digits (99.7 and 5 % give 104.7 and 94.7).
+ */
+export declare const cpiThresholds: (referenceArg: ICpiValue, percentArg: string) => ICpiThresholds;
+/**
+ * The first value after the reference period that reaches a threshold of a percent rule
+ * (`cpiThresholds`), or `undefined` while none does. Whether the threshold itself counts (`reached`) or
+ * only a value beyond it (`exceeded`), and which direction, is the clause's to say. All values must be
+ * published values of the reference value's series and base; their order does not matter, a period
+ * given twice is refused.
+ */
+export declare const cpiFirstReaching: (valuesArg: readonly ICpiValue[], referenceArg: ICpiValue, percentArg: string, optionsArg: ICpiReachOptions) => ICpiValue | undefined;
+/**
+ * An amount in cents scaled from one index value to another, rounded half away from zero to whole cents:
+ * by the index ratio (amount × new / old, the default, as the Statistisches Bundesamt writes it) or by
+ * the change in percent rounded to one decimal (`basis: 'rounded_percent'`). Which one applies is the
+ * contract's to say. The amount and the result are safe integers; a negative amount (a credit) scales
+ * the same way.
+ */
+export declare const cpiScaleAmount: (amountCentsArg: number, oldArg: ICpiValue, newArg: ICpiValue, optionsArg?: ICpiScaleOptions) => number;