bcchapi 1.0.9 → 2.0.0

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC"}

package/dist/utils/stats.d.ts

@@ -0,0 +1,112 @@
+import type { Observation } from '../client/types.js';
+/**
+ * Calculates the arithmetic mean of valid observation values, ignoring gaps.
+ *
+ * @param observations - Array of observations.
+ * @returns The arithmetic mean.
+ * @throws {Error} When there are no valid (non-null) values.
+ *
+ * @example
+ * ```ts
+ * mean(data.observations); // 1.78
+ * ```
+ */
+export declare function mean(observations: Observation[]): number;
+/**
+ * Calculates the sample standard deviation of valid observation values,
+ * ignoring gaps.
+ *
+ * Uses Bessel's correction (divides by `n - 1`).
+ *
+ * @param observations - Array of observations.
+ * @returns The sample standard deviation.
+ * @throws {Error} When fewer than two valid values are present.
+ *
+ * @example
+ * ```ts
+ * stdDev(data.observations); // 0.035
+ * ```
+ */
+export declare function stdDev(observations: Observation[]): number;
+/**
+ * Returns the minimum valid observation value, ignoring gaps.
+ *
+ * @param observations - Array of observations.
+ * @returns The minimum value.
+ * @throws {Error} When there are no valid values.
+ *
+ * @example
+ * ```ts
+ * min(data.observations); // 0.5
+ * ```
+ */
+export declare function min(observations: Observation[]): number;
+/**
+ * Returns the maximum valid observation value, ignoring gaps.
+ *
+ * @param observations - Array of observations.
+ * @returns The maximum value.
+ * @throws {Error} When there are no valid values.
+ *
+ * @example
+ * ```ts
+ * max(data.observations); // 8.25
+ * ```
+ */
+export declare function max(observations: Observation[]): number;
+/**
+ * Calculates period-over-period fractional change for each observation.
+ *
+ * The result at index `i` is `value[i] / value[i-1] - 1`.
+ * Returns `null` for the first position, and for any position where the
+ * current or previous value is `null`.
+ *
+ * @param observations - Array of observations in chronological order.
+ * @returns Array of fractional changes, same length as input, `null` for gaps.
+ *
+ * @example
+ * ```ts
+ * // values: 100, 105, null, 110
+ * periodVariation(obs); // [null, 0.05, null, null]
+ * ```
+ */
+export declare function periodVariation(observations: Observation[]): Array<number | null>;
+/**
+ * Calculates year-over-year fractional change using a fixed period offset.
+ *
+ * The result at index `i` is `value[i] / value[i - periodsPerYear] - 1`.
+ * Returns `null` for the first `periodsPerYear` positions, and for any
+ * position where the current or base value is `null`.
+ *
+ * @param observations - Array of observations in chronological order.
+ * @param periodsPerYear - Number of periods per year (e.g. `12` for monthly,
+ *   `4` for quarterly, `252` for daily trading days).
+ * @returns Array of fractional changes, same length as input.
+ * @throws {Error} When `periodsPerYear` is not a positive integer.
+ *
+ * @example
+ * ```ts
+ * // Monthly CPI, 12-month change
+ * annualVariation(cpi.observations, 12);
+ * ```
+ */
+export declare function annualVariation(observations: Observation[], periodsPerYear: number): Array<number | null>;
+/**
+ * Calculates a rolling (moving) average over a fixed window of observations.
+ *
+ * Returns `null` for positions before the window is full, and for any window
+ * that contains at least one gap value.
+ *
+ * @param observations - Array of observations in chronological order.
+ * @param window - Number of periods in the rolling window.
+ * @returns Array of rolling means, same length as input.
+ * @throws {Error} When `window` is not a positive integer.
+ *
+ * @example
+ * ```ts
+ * // 3-month moving average
+ * rollingMean(data.observations, 3);
+ * ```
+ */
+export declare function rollingMean(observations: Observation[], window: number): Array<number | null>;
+//# sourceMappingURL=stats.d.ts.map

package/dist/utils/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/utils/stats.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAatD;;;;;;;;;;;GAWG;AACH,wBAAgB,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,MAAM,CAMxD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,MAAM,CAQ1D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,MAAM,CAMvD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,MAAM,CAMvD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAQjF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,WAAW,EAAE,EAC3B,cAAc,EAAE,MAAM,GACrB,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAYtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAa7F"}

package/dist/utils/stats.js

@@ -0,0 +1,185 @@
+import { parseValue } from './transform.js';
+function validNumbers(observations) {
+    const result = [];
+    for (const obs of observations) {
+        const n = parseValue(obs.value);
+        if (n !== null) {
+            result.push(n);
+        }
+    }
+    return result;
+}
+/**
+ * Calculates the arithmetic mean of valid observation values, ignoring gaps.
+ *
+ * @param observations - Array of observations.
+ * @returns The arithmetic mean.
+ * @throws {Error} When there are no valid (non-null) values.
+ *
+ * @example
+ * ```ts
+ * mean(data.observations); // 1.78
+ * ```
+ */
+export function mean(observations) {
+    const values = validNumbers(observations);
+    if (values.length === 0) {
+        throw new Error('No valid observations to compute mean');
+    }
+    return values.reduce((sum, v) => sum + v, 0) / values.length;
+}
+/**
+ * Calculates the sample standard deviation of valid observation values,
+ * ignoring gaps.
+ *
+ * Uses Bessel's correction (divides by `n - 1`).
+ *
+ * @param observations - Array of observations.
+ * @returns The sample standard deviation.
+ * @throws {Error} When fewer than two valid values are present.
+ *
+ * @example
+ * ```ts
+ * stdDev(data.observations); // 0.035
+ * ```
+ */
+export function stdDev(observations) {
+    const values = validNumbers(observations);
+    if (values.length < 2) {
+        throw new Error('stdDev requires at least two valid observations');
+    }
+    const avg = values.reduce((sum, v) => sum + v, 0) / values.length;
+    const variance = values.reduce((sum, v) => sum + (v - avg) ** 2, 0) / (values.length - 1);
+    return Math.sqrt(variance);
+}
+/**
+ * Returns the minimum valid observation value, ignoring gaps.
+ *
+ * @param observations - Array of observations.
+ * @returns The minimum value.
+ * @throws {Error} When there are no valid values.
+ *
+ * @example
+ * ```ts
+ * min(data.observations); // 0.5
+ * ```
+ */
+export function min(observations) {
+    const values = validNumbers(observations);
+    if (values.length === 0) {
+        throw new Error('No valid observations to compute min');
+    }
+    return Math.min(...values);
+}
+/**
+ * Returns the maximum valid observation value, ignoring gaps.
+ *
+ * @param observations - Array of observations.
+ * @returns The maximum value.
+ * @throws {Error} When there are no valid values.
+ *
+ * @example
+ * ```ts
+ * max(data.observations); // 8.25
+ * ```
+ */
+export function max(observations) {
+    const values = validNumbers(observations);
+    if (values.length === 0) {
+        throw new Error('No valid observations to compute max');
+    }
+    return Math.max(...values);
+}
+/**
+ * Calculates period-over-period fractional change for each observation.
+ *
+ * The result at index `i` is `value[i] / value[i-1] - 1`.
+ * Returns `null` for the first position, and for any position where the
+ * current or previous value is `null`.
+ *
+ * @param observations - Array of observations in chronological order.
+ * @returns Array of fractional changes, same length as input, `null` for gaps.
+ *
+ * @example
+ * ```ts
+ * // values: 100, 105, null, 110
+ * periodVariation(obs); // [null, 0.05, null, null]
+ * ```
+ */
+export function periodVariation(observations) {
+    const values = observations.map((obs) => parseValue(obs.value));
+    return values.map((current, i) => {
+        if (i === 0)
+            return null;
+        const previous = values[i - 1] ?? null;
+        if (current === null || previous === null || previous === 0)
+            return null;
+        return current / previous - 1;
+    });
+}
+/**
+ * Calculates year-over-year fractional change using a fixed period offset.
+ *
+ * The result at index `i` is `value[i] / value[i - periodsPerYear] - 1`.
+ * Returns `null` for the first `periodsPerYear` positions, and for any
+ * position where the current or base value is `null`.
+ *
+ * @param observations - Array of observations in chronological order.
+ * @param periodsPerYear - Number of periods per year (e.g. `12` for monthly,
+ *   `4` for quarterly, `252` for daily trading days).
+ * @returns Array of fractional changes, same length as input.
+ * @throws {Error} When `periodsPerYear` is not a positive integer.
+ *
+ * @example
+ * ```ts
+ * // Monthly CPI, 12-month change
+ * annualVariation(cpi.observations, 12);
+ * ```
+ */
+export function annualVariation(observations, periodsPerYear) {
+    if (!Number.isInteger(periodsPerYear) || periodsPerYear < 1) {
+        throw new Error(`periodsPerYear must be a positive integer, got: ${periodsPerYear}`);
+    }
+    const values = observations.map((obs) => parseValue(obs.value));
+    return values.map((current, i) => {
+        if (i < periodsPerYear)
+            return null;
+        const base = values[i - periodsPerYear] ?? null;
+        if (current === null || base === null || base === 0)
+            return null;
+        return current / base - 1;
+    });
+}
+/**
+ * Calculates a rolling (moving) average over a fixed window of observations.
+ *
+ * Returns `null` for positions before the window is full, and for any window
+ * that contains at least one gap value.
+ *
+ * @param observations - Array of observations in chronological order.
+ * @param window - Number of periods in the rolling window.
+ * @returns Array of rolling means, same length as input.
+ * @throws {Error} When `window` is not a positive integer.
+ *
+ * @example
+ * ```ts
+ * // 3-month moving average
+ * rollingMean(data.observations, 3);
+ * ```
+ */
+export function rollingMean(observations, window) {
+    if (!Number.isInteger(window) || window < 1) {
+        throw new Error(`window must be a positive integer, got: ${window}`);
+    }
+    const values = observations.map((obs) => parseValue(obs.value));
+    return values.map((_, i) => {
+        if (i < window - 1)
+            return null;
+        const slice = values.slice(i - window + 1, i + 1);
+        if (slice.some((v) => v === null))
+            return null;
+        const sum = slice.reduce((acc, v) => acc + v, 0);
+        return sum / window;
+    });
+}
+//# sourceMappingURL=stats.js.map

package/dist/utils/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../src/utils/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,SAAS,YAAY,CAAC,YAA2B;IAC/C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,IAAI,CAAC,YAA2B;IAC9C,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;AAC/D,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,MAAM,CAAC,YAA2B;IAChD,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC1C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IAClE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC1F,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,GAAG,CAAC,YAA2B;IAC7C,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,GAAG,CAAC,YAA2B;IAC7C,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAAC,YAA2B;IACzD,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE;QAC/B,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC;QACvC,IAAI,OAAO,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACzE,OAAO,OAAO,GAAG,QAAQ,GAAG,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,eAAe,CAC7B,YAA2B,EAC3B,cAAsB;IAEtB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,mDAAmD,cAAc,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE;QAC/B,IAAI,CAAC,GAAG,cAAc;YAAE,OAAO,IAAI,CAAC;QACpC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,cAAc,CAAC,IAAI,IAAI,CAAC;QAChD,IAAI,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACjE,OAAO,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,WAAW,CAAC,YAA2B,EAAE,MAAc;IACrE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,2CAA2C,MAAM,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACzB,IAAI,CAAC,GAAG,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAClD,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/C,MAAM,GAAG,GAAI,KAAkB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/D,OAAO,GAAG,GAAG,MAAM,CAAC;IACtB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/transform.d.ts

@@ -0,0 +1,79 @@
+import type { Observation } from '../client/types.js';
+/**
+ * Parses a raw observation value string to a number, or `null` for gaps.
+ *
+ * @param value - Raw value string from an {@link Observation}.
+ * @returns The parsed number, or `null` when the string is empty or non-numeric.
+ *
+ * @example
+ * ```ts
+ * parseValue('1.75');  // 1.75
+ * parseValue('');      // null
+ * parseValue('N/A');   // null
+ * ```
+ */
+export declare function parseValue(value: string): number | null;
+/**
+ * Filters an array of observations, returning only those with parseable values.
+ *
+ * An observation is considered valid when its `value` field is a non-empty,
+ * numeric string (i.e. `parseValue` returns a number, not `null`).
+ *
+ * @param observations - Array of observations to filter.
+ * @returns A new array containing only the valid observations.
+ *
+ * @example
+ * ```ts
+ * const valid = filterValid(data.observations);
+ * ```
+ */
+export declare function filterValid(observations: Observation[]): Observation[];
+/**
+ * Converts an array of observations to an array of `number | null` values.
+ *
+ * Gaps (empty or non-numeric values) are represented as `null`, preserving
+ * the positional alignment with the original observations array.
+ *
+ * @param observations - Array of observations to convert.
+ * @returns Array of parsed values, `null` for gaps.
+ *
+ * @example
+ * ```ts
+ * toNumbers(data.observations); // [1.75, null, 1.80, ...]
+ * ```
+ */
+export declare function toNumbers(observations: Observation[]): Array<number | null>;
+/**
+ * Converts an array of observations to a `Map` keyed by the observation date
+ * string (`"DD-MM-YYYY"`).
+ *
+ * When duplicate dates exist, the last one wins. Values are `null` for gaps.
+ *
+ * @param observations - Array of observations to convert.
+ * @returns Map from date string to `number | null`.
+ *
+ * @example
+ * ```ts
+ * const map = toMap(data.observations);
+ * map.get('01-01-2024'); // 1.75
+ * ```
+ */
+export declare function toMap(observations: Observation[]): Map<string, number | null>;
+/**
+ * Converts an array of observations to parallel `dates` and `values` arrays
+ * suitable for charting libraries.
+ *
+ * @param observations - Array of observations to convert.
+ * @returns Object with `dates` (UTC `Date[]`) and `values` (`Array<number | null>`).
+ *
+ * @example
+ * ```ts
+ * const { dates, values } = toArrays(data.observations);
+ * // pass to Chart.js, D3, etc.
+ * ```
+ */
+export declare function toArrays(observations: Observation[]): {
+    dates: Date[];
+    values: Array<number | null>;
+};
+//# sourceMappingURL=transform.d.ts.map

package/dist/utils/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/utils/transform.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOvD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAEtE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAE3E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAM7E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG;IACrD,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC9B,CAQA"}

package/dist/utils/transform.js

@@ -0,0 +1,101 @@
+import { parseObservationDate } from './dates.js';
+/**
+ * Parses a raw observation value string to a number, or `null` for gaps.
+ *
+ * @param value - Raw value string from an {@link Observation}.
+ * @returns The parsed number, or `null` when the string is empty or non-numeric.
+ *
+ * @example
+ * ```ts
+ * parseValue('1.75');  // 1.75
+ * parseValue('');      // null
+ * parseValue('N/A');   // null
+ * ```
+ */
+export function parseValue(value) {
+    const trimmed = value.trim();
+    if (trimmed === '') {
+        return null;
+    }
+    const n = Number(trimmed);
+    return isNaN(n) ? null : n;
+}
+/**
+ * Filters an array of observations, returning only those with parseable values.
+ *
+ * An observation is considered valid when its `value` field is a non-empty,
+ * numeric string (i.e. `parseValue` returns a number, not `null`).
+ *
+ * @param observations - Array of observations to filter.
+ * @returns A new array containing only the valid observations.
+ *
+ * @example
+ * ```ts
+ * const valid = filterValid(data.observations);
+ * ```
+ */
+export function filterValid(observations) {
+    return observations.filter((obs) => parseValue(obs.value) !== null);
+}
+/**
+ * Converts an array of observations to an array of `number | null` values.
+ *
+ * Gaps (empty or non-numeric values) are represented as `null`, preserving
+ * the positional alignment with the original observations array.
+ *
+ * @param observations - Array of observations to convert.
+ * @returns Array of parsed values, `null` for gaps.
+ *
+ * @example
+ * ```ts
+ * toNumbers(data.observations); // [1.75, null, 1.80, ...]
+ * ```
+ */
+export function toNumbers(observations) {
+    return observations.map((obs) => parseValue(obs.value));
+}
+/**
+ * Converts an array of observations to a `Map` keyed by the observation date
+ * string (`"DD-MM-YYYY"`).
+ *
+ * When duplicate dates exist, the last one wins. Values are `null` for gaps.
+ *
+ * @param observations - Array of observations to convert.
+ * @returns Map from date string to `number | null`.
+ *
+ * @example
+ * ```ts
+ * const map = toMap(data.observations);
+ * map.get('01-01-2024'); // 1.75
+ * ```
+ */
+export function toMap(observations) {
+    const result = new Map();
+    for (const obs of observations) {
+        result.set(obs.indexDateString, parseValue(obs.value));
+    }
+    return result;
+}
+/**
+ * Converts an array of observations to parallel `dates` and `values` arrays
+ * suitable for charting libraries.
+ *
+ * @param observations - Array of observations to convert.
+ * @returns Object with `dates` (UTC `Date[]`) and `values` (`Array<number | null>`).
+ *
+ * @example
+ * ```ts
+ * const { dates, values } = toArrays(data.observations);
+ * // pass to Chart.js, D3, etc.
+ * ```
+ */
+export function toArrays(observations) {
+    const dates = [];
+    const values = [];
+    for (const obs of observations) {
+        dates.push(parseObservationDate(obs.indexDateString));
+        values.push(parseValue(obs.value));
+    }
+    return { dates, values };
+}
+//# sourceMappingURL=transform.js.map

package/dist/utils/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../src/utils/transform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1B,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CAAC,YAA2B;IACrD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS,CAAC,YAA2B;IACnD,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,KAAK,CAAC,YAA2B;IAC/C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAChD,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,QAAQ,CAAC,YAA2B;IAIlD,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,MAAM,MAAM,GAAyB,EAAE,CAAC;IACxC,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;QACtD,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC"}

package/package.json

@@ -1,52 +1,74 @@
 {
   "name": "bcchapi",
-  "version": "1.0.9",
-  "description": "API para acceder al Web Service del Banco Central de Chile.",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "scripts": {
-    "build": "rimraf dist && tsc",
-    "test": "vitest",
-    "coverage": "vitest --coverage",
-    "lint": "eslint --ignore-path .eslintignore --ext .ts",
-    "format": "prettier --ignore-path .gitignore --write \"**/*.+(js|ts|json)\""
+  "version": "2.0.0",
+  "description": "Node.js wrapper for the Banco Central de Chile API. Features a fully typed API client and utility tools to streamline macroeconomic data integration.",
+  "homepage": "https://github.com/airarrazaval/bcchapi#readme",
+  "bugs": {
+    "url": "https://github.com/airarrazaval/bcchapi/issues"
   },
+  "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/airarrazaval/bcchapi.git"
+    "url": "https://github.com/airarrazaval/bcchapi.git"
   },
-  "keywords": [
-    "node",
-    "javascript",
-    "typescript",
-    "bcchapi"
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
   ],
-  "author": "Alfredo Irarrazaval",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/airarrazaval/bcchapi/issues"
+  "type": "module",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js",
+      "default": "./dist/client/index.js"
+    },
+    "./series": {
+      "types": "./dist/series/index.d.ts",
+      "import": "./dist/series/index.js",
+      "default": "./dist/series/index.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.js",
+      "default": "./dist/utils/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "node --import tsx/esm --test --watch \"tests/**/*.test.ts\"",
+    "test": "node --import tsx/esm --test \"tests/**/*.test.ts\"",
+    "test:coverage": "node --test-coverage --import tsx/esm --test \"tests/**/*.test.ts\"",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint src tests",
+    "lint:fix": "oxlint --fix src tests",
+    "format": "oxfmt",
+    "format:check": "oxfmt --check",
+    "clean": "rm -rf dist docs",
+    "docs": "typedoc",
+    "changelog": "git-cliff --bump -o CHANGELOG.md",
+    "prepublishOnly": "npm run typecheck && npm run lint && npm run clean && npm run build"
   },
-  "homepage": "https://github.com/airarrazaval/bcchapi#readme",
   "devDependencies": {
-    "@tsconfig/node20": "^20.1.4",
-    "@types/node": "^20.14.2",
-    "@typescript-eslint/eslint-plugin": "^6.21.0",
-    "@typescript-eslint/parser": "^6.21.0",
-    "@vitest/coverage-v8": "^3.0.6",
-    "eslint": "^8.57.0",
-    "eslint-config-prettier": "^9.1.0",
-    "eslint-plugin-import": "^2.29.1",
-    "prettier": "^3.3.2",
-    "rimraf": "^6.0.1",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.4.5",
-    "vitest": "^3.0.6"
+    "@types/node": "^24.12.0",
+    "git-cliff": "^2.12.0",
+    "oxfmt": "^0.36.0",
+    "oxlint": "^1.51.0",
+    "tsx": "^4.21.0",
+    "typedoc": "^0.28.17",
+    "typescript": "^5.8.0"
   },
   "engines": {
-    "node": ">=18.19.0",
-    "npm": ">=10.2.3"
-  },
-  "volta": {
-    "node": "20.11.0"
+    "node": ">=24.0.0"
   }
-}
+}

package/.eslintignore

@@ -1,3 +0,0 @@
-node_modules
-coverage
-dist

package/.eslintrc.json

@@ -1,21 +0,0 @@
-{
-  "env": {
-    "es2021": true,
-    "node": true
-  },
-  "extends": ["eslint:recommended", "plugin:@typescript-eslint/recommended", "prettier"],
-  "overrides": [],
-  "parser": "@typescript-eslint/parser",
-  "parserOptions": {
-    "ecmaVersion": "latest",
-    "sourceType": "module",
-    "project": "./tsconfig.eslint.json"
-  },
-  "plugins": ["@typescript-eslint"],
-  "rules": {
-    "max-classes-per-file": "off",
-    "eol-last": ["error", "always"],
-    "@typescript-eslint/no-unused-vars": "error",
-    "@typescript-eslint/consistent-type-definitions": ["error", "interface"]
-  }
-}