bcchapi 2.1.0 → 2.2.1

package/CHANGELOG.md

@@ -6,6 +6,33 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and
 
 ---
 
+## [2.2.1] - 2026-03-10
+
+
+### Changed
+
+- Add npm keywords for discoverability
+
+
+---
+## [2.2.0] - 2026-03-10
+
+
+### Added
+
+- Add fillForward utility
+
+
+### Changed
+
+- Release v2.2.0
+- Always run format before check in dev workflow
+- Fix formatting
+- Add check script and move release docs to CONTRIBUTING.md
+- Update README for v2.1.0 caching and fix AGENTS.md checklists
+
+
+---
 ## [2.1.0] - 2026-03-10
 
 
@@ -16,6 +43,8 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and
 
 ### Changed
 
+- Bump version to 2.1.0
+- Release v2.1.0
 - Fix formatting
 
 

package/README.md

@@ -38,7 +38,7 @@ console.log(data.observations); // [{ indexDateString, value, statusCode }, ...]
 ### Transform observations
 
 ```ts
-import { toNumbers, toArrays, filterValid, mean, rollingMean } from 'bcchapi/utils';
+import { toNumbers, toArrays, filterValid, fillForward, mean, rollingMean } from 'bcchapi/utils';
 
 // Parse values to number | null (null for gaps)
 const values = toNumbers(data.observations); // [37000.12, null, 37050.45, ...]
@@ -49,6 +49,11 @@ const { dates, values } = toArrays(data.observations);
 // Filter out gap observations
 const valid = filterValid(data.observations);
 
+// Fill gaps by carrying the last valid value forward (e.g. weekends, holidays)
+// Throws if the first observation has no valid value — ensure the start date
+// falls on a trading day.
+const filled = fillForward(data.observations);
+
 // Summary statistics (gaps are ignored)
 const avg = mean(data.observations);
 
@@ -75,6 +80,39 @@ const monthlySeries = await client.searchSeries('MONTHLY');
 console.log(monthlySeries.map((s) => s.englishTitle));
 ```
 
+### Enable caching
+
+```ts
+import { Client } from 'bcchapi/client';
+import { MemoryCache } from 'bcchapi/cache';
+
+const client = new Client({
+  user: 'me@example.com',
+  pass: 'secret',
+  cache: new MemoryCache({ defaultTtlMs: 60 * 60 * 1000 }), // 1 hour
+});
+
+// Repeated calls with the same arguments hit the cache — no HTTP request
+const data = await client.getSeries(SERIES.PRICES.UF);
+```
+
+Bring your own backend by implementing the `Cache` interface:
+
+```ts
+import type { Cache } from 'bcchapi/cache';
+
+const redisCache: Cache = {
+  get: (key) => {
+    /* ... */
+  },
+  set: (key, value, ttlMs) => {
+    /* ... */
+  },
+};
+
+const client = new Client({ user, pass, cache: redisCache });
+```
+
 ### Error handling
 
 ```ts
@@ -102,11 +140,13 @@ try {
 
 #### `new Client(options)`
 
-| Option  | Type           | Description                                                |
-| ------- | -------------- | ---------------------------------------------------------- |
-| `user`  | `string`       | BCCH account email                                         |
-| `pass`  | `string`       | BCCH account password                                      |
-| `fetch` | `typeof fetch` | Custom fetch implementation (optional, useful for testing) |
+| Option       | Type           | Description                                                                       |
+| ------------ | -------------- | --------------------------------------------------------------------------------- |
+| `user`       | `string`       | BCCH account email                                                                |
+| `pass`       | `string`       | BCCH account password                                                             |
+| `fetch`      | `typeof fetch` | Custom fetch implementation (optional, useful for testing)                        |
+| `cache`      | `Cache`        | Cache backend (optional) — any object satisfying the `Cache` interface            |
+| `cacheTtlMs` | `number`       | TTL in milliseconds passed to `cache.set` on every successful response (optional) |
 
 #### `client.getSeries(seriesId, options?)`
 
@@ -126,6 +166,27 @@ Returns metadata for all series with the given frequency. `frequency` is one of
 
 Returns `Promise<SeriesInfo[]>`.
 
+### `bcchapi/cache`
+
+#### `Cache` interface
+
+Minimal interface for plugging in any cache backend:
+
+```ts
+interface Cache {
+  get(key: string): unknown;
+  set(key: string, value: unknown, ttlMs?: number): void;
+}
+```
+
+#### `new MemoryCache(options?)`
+
+Built-in in-memory cache. Entries are evicted lazily on `get` — no background timers.
+
+| Option         | Type     | Description                                                      |
+| -------------- | -------- | ---------------------------------------------------------------- |
+| `defaultTtlMs` | `number` | Default TTL in milliseconds. Omit for entries that never expire. |
+
 ### `bcchapi/series`
 
 `SERIES` is a nested `as const` object of curated series IDs grouped by domain:
@@ -148,15 +209,16 @@ Use [si3.bcentral.cl](https://si3.bcentral.cl/siete) or `client.searchSeries()`
 
 #### Transform functions
 
-| Function                           | Description                                                                 |
-| ---------------------------------- | --------------------------------------------------------------------------- |
-| `parseValue(value)`                | Parses a value string to `number \| null` (`null` for empty or non-numeric) |
-| `filterValid(observations)`        | Returns only observations with parseable numeric values                     |
-| `toNumbers(observations)`          | Maps observations to `Array<number \| null>`                                |
-| `toMap(observations)`              | Returns a `Map<string, number \| null>` keyed by `indexDateString`          |
-| `toArrays(observations)`           | Returns `{ dates: Date[], values: Array<number \| null> }`                  |
-| `parseObservationDate(dateString)` | Parses `"DD-MM-YYYY"` to a UTC `Date`                                       |
-| `formatQueryDate(date)`            | Formats a `Date` to `"YYYY-MM-DD"` for use in `getSeries` options           |
+| Function                           | Description                                                                                                          |
+| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `parseValue(value)`                | Parses a value string to `number \| null` (`null` for empty or non-numeric)                                          |
+| `filterValid(observations)`        | Returns only observations with parseable numeric values                                                              |
+| `toNumbers(observations)`          | Maps observations to `Array<number \| null>`                                                                         |
+| `toMap(observations)`              | Returns a `Map<string, number \| null>` keyed by `indexDateString`                                                   |
+| `toArrays(observations)`           | Returns `{ dates: Date[], values: Array<number \| null> }`                                                           |
+| `fillForward(observations)`        | Fills gap observations by carrying the last valid value forward. Throws if the first observation has no valid value. |
+| `parseObservationDate(dateString)` | Parses `"DD-MM-YYYY"` to a UTC `Date`                                                                                |
+| `formatQueryDate(date)`            | Formats a `Date` to `"YYYY-MM-DD"` for use in `getSeries` options                                                    |
 
 #### Statistics functions
 
@@ -172,19 +234,19 @@ All stats functions operate on `Observation[]` and ignore gap values (empty or n
 | `annualVariation(observations, periodsPerYear)` | Year-over-year fractional change (`value[i] / value[i - n] - 1`)         |
 | `rollingMean(observations, window)`             | Rolling mean over a fixed window; `null` if any value in window is a gap |
 
-## Releases
+## Terms of Use
 
-```sh
-# 1. Regenerate CHANGELOG.md (auto-determines next version)
-npm run changelog
+Use of the Banco Central de Chile API is subject to their [terms and conditions](https://si3.bcentral.cl/estadisticas/Principal1/Web_Services/index_BDE_TC.htm). Key points:
 
-# 2. Commit and bump version
-git add CHANGELOG.md && git commit -m "chore: release vX.Y.Z"
-npm version patch  # or minor / major
+- **Registration required** — you must register and accept the terms at [si3.bcentral.cl](https://si3.bcentral.cl/siete) to obtain credentials.
+- **Rate limit** — maximum 5 simultaneous requests per second per account. The API does not support bulk or parallel fetching.
+- **Attribution** — any application or publication that uses data from this API must credit **Banco Central de Chile** as the original source.
 
-# 3. Push — the publish workflow triggers automatically on the version tag
-git push --follow-tags
-```
+This library does not redistribute any data. All data is fetched directly from the official API at runtime by the consuming application.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## License
 

package/dist/index.d.ts

@@ -3,5 +3,5 @@ export type { Cache, ClientOptions, Frequency, GetSeriesOptions, Observation, Se
 export { MemoryCache } from './cache/index.js';
 export type { MemoryCacheOptions } from './cache/index.js';
 export { SERIES } from './series/index.js';
-export { parseObservationDate, formatQueryDate, filterValid, parseValue, toArrays, toMap, toNumbers, annualVariation, max, mean, min, periodVariation, rollingMean, stdDev, } from './utils/index.js';
+export { parseObservationDate, formatQueryDate, fillForward, filterValid, parseValue, toArrays, toMap, toNumbers, annualVariation, max, mean, min, periodVariation, rollingMean, stdDev, } from './utils/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAChE,YAAY,EACV,KAAK,EACL,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,UAAU,GACX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,UAAU,EACV,QAAQ,EACR,KAAK,EACL,SAAS,EACT,eAAe,EACf,GAAG,EACH,IAAI,EACJ,GAAG,EACH,eAAe,EACf,WAAW,EACX,MAAM,GACP,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAChE,YAAY,EACV,KAAK,EACL,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,UAAU,GACX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,WAAW,EACX,UAAU,EACV,QAAQ,EACR,KAAK,EACL,SAAS,EACT,eAAe,EACf,GAAG,EACH,IAAI,EACJ,GAAG,EACH,eAAe,EACf,WAAW,EACX,MAAM,GACP,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 export { Client, ApiError, HttpError } from './client/index.js';
 export { MemoryCache } from './cache/index.js';
 export { SERIES } from './series/index.js';
-export { parseObservationDate, formatQueryDate, filterValid, parseValue, toArrays, toMap, toNumbers, annualVariation, max, mean, min, periodVariation, rollingMean, stdDev, } from './utils/index.js';
+export { parseObservationDate, formatQueryDate, fillForward, filterValid, parseValue, toArrays, toMap, toNumbers, annualVariation, max, mean, min, periodVariation, rollingMean, stdDev, } from './utils/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAWhE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,UAAU,EACV,QAAQ,EACR,KAAK,EACL,SAAS,EACT,eAAe,EACf,GAAG,EACH,IAAI,EACJ,GAAG,EACH,eAAe,EACf,WAAW,EACX,MAAM,GACP,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAWhE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,WAAW,EACX,UAAU,EACV,QAAQ,EACR,KAAK,EACL,SAAS,EACT,eAAe,EACf,GAAG,EACH,IAAI,EACJ,GAAG,EACH,eAAe,EACf,WAAW,EACX,MAAM,GACP,MAAM,kBAAkB,CAAC"}

package/dist/utils/index.d.ts

@@ -1,4 +1,4 @@
 export { formatQueryDate, parseObservationDate } from './dates.js';
-export { filterValid, parseValue, toArrays, toMap, toNumbers } from './transform.js';
+export { fillForward, filterValid, parseValue, toArrays, toMap, toNumbers } from './transform.js';
 export { annualVariation, max, mean, min, periodVariation, rollingMean, stdDev } from './stats.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC"}

package/dist/utils/index.js

@@ -1,4 +1,4 @@
 export { formatQueryDate, parseObservationDate } from './dates.js';
-export { filterValid, parseValue, toArrays, toMap, toNumbers } from './transform.js';
+export { fillForward, filterValid, parseValue, toArrays, toMap, toNumbers } from './transform.js';
 export { annualVariation, max, mean, min, periodVariation, rollingMean, stdDev } from './stats.js';
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +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"}
+{"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,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC"}

package/dist/utils/transform.d.ts

@@ -1,4 +1,23 @@
 import type { Observation } from '../client/types.js';
+/**
+ * Fills forward gap observations using the last valid value seen.
+ *
+ * Each gap (empty or non-numeric `value`) is replaced with the `value` string
+ * of the most recent valid observation. The original `indexDateString` and
+ * `statusCode` of each observation are preserved.
+ *
+ * @param observations - Array of observations to fill.
+ * @returns A new array of the same length with gaps filled forward.
+ * @throws {Error} When the first observation has no valid value. Ensure the
+ *   start date falls on a trading day with an available observation.
+ *
+ * @example
+ * ```ts
+ * const filled = fillForward(data.observations);
+ * // Gap observations now carry the last known value forward
+ * ```
+ */
+export declare function fillForward(observations: Observation[]): Observation[];
 /**
  * Parses a raw observation value string to a number, or `null` for gaps.
  *

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

@@ -1 +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"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/utils/transform.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAmBtE;AAED;;;;;;;;;;;;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

@@ -1,4 +1,38 @@
 import { parseObservationDate } from './dates.js';
+/**
+ * Fills forward gap observations using the last valid value seen.
+ *
+ * Each gap (empty or non-numeric `value`) is replaced with the `value` string
+ * of the most recent valid observation. The original `indexDateString` and
+ * `statusCode` of each observation are preserved.
+ *
+ * @param observations - Array of observations to fill.
+ * @returns A new array of the same length with gaps filled forward.
+ * @throws {Error} When the first observation has no valid value. Ensure the
+ *   start date falls on a trading day with an available observation.
+ *
+ * @example
+ * ```ts
+ * const filled = fillForward(data.observations);
+ * // Gap observations now carry the last known value forward
+ * ```
+ */
+export function fillForward(observations) {
+    if (observations.length === 0) {
+        return [];
+    }
+    if (parseValue(observations[0].value) === null) {
+        throw new Error('fillForward: first observation has no valid value — ensure the start date falls on a trading day');
+    }
+    let lastValue = observations[0].value;
+    return observations.map((obs) => {
+        if (parseValue(obs.value) !== null) {
+            lastValue = obs.value;
+            return obs;
+        }
+        return { ...obs, value: lastValue };
+    });
+}
 /**
  * Parses a raw observation value string to a number, or `null` for gaps.
  *

package/dist/utils/transform.js.map

@@ -1 +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"}
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../src/utils/transform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,WAAW,CAAC,YAA2B;IACrD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,kGAAkG,CACnG,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,GAAG,YAAY,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC;IACvC,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC9B,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;YACnC,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC;YACtB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;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,12 +1,26 @@
 {
   "name": "bcchapi",
-  "version": "2.1.0",
+  "version": "2.2.1",
   "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",
+  "keywords": [
+    "bcch",
+    "banco-central",
+    "banco-central-de-chile",
+    "chile",
+    "economics",
+    "macroeconomics",
+    "api",
+    "api-client",
+    "time-series",
+    "finance",
+    "uf",
+    "utm"
+  ],
   "repository": {
     "type": "git",
     "url": "https://github.com/airarrazaval/bcchapi.git"
@@ -59,10 +73,11 @@
     "lint:fix": "oxlint --fix src tests",
     "format": "oxfmt",
     "format:check": "oxfmt --check",
+    "check": "npm run typecheck && npm run lint && npm test",
     "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"
+    "prepublishOnly": "npm run check && npm run clean && npm run build"
   },
   "devDependencies": {
     "@types/node": "^24.12.0",