bcchapi 1.0.2 → 1.0.4

package/README.md

@@ -78,7 +78,7 @@ _Output_
 
 ### SearchSeries
 
-Allows you to search for series by their frequency code (ie: daily, weekly, monthly, yearly).
+Allows you to search for series by their frequency code (ie: daily, monthly, quarterly, yearly).
 
 #### Parameters
 

package/dist/client.js

@@ -22,15 +22,11 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Client = exports.Frequency = void 0;
 const querystring = __importStar(require("node:querystring"));
 const assert = __importStar(require("node:assert/strict"));
-const parsers_1 = require("./helpers/parsers");
-const is_valid_date_1 = __importDefault(require("./helpers/is-valid-date"));
+const utils_1 = require("./utils");
 var Frequency;
 (function (Frequency) {
     Frequency["Daily"] = "DAILY";
@@ -65,17 +61,17 @@ class Client {
             function: 'GetSeries',
         };
         if (since) {
-            assert.ok((0, is_valid_date_1.default)(since), '"since" is not a valid date string or Date object');
+            assert.ok((0, utils_1.isValidDate)(since), '"since" is not a valid date string or Date object');
             query.firstdate = typeof since === 'string' ? since : since.toISOString().slice(0, 10);
         }
         if (until) {
-            assert.ok((0, is_valid_date_1.default)(until), '"until" is not a valid date string or Date object');
+            assert.ok((0, utils_1.isValidDate)(until), '"until" is not a valid date string or Date object');
             query.lastdate = typeof until === 'string' ? until : until.toISOString().slice(0, 10);
         }
         if (query.firstdate && query.lastdate) {
             assert.ok(query.firstdate <= query.lastdate, 'invalid date range');
         }
-        return this.request(query).then(parsers_1.parseGetSeriesResponse);
+        return this.request(query).then(utils_1.parseGetSeriesResponse);
     }
     /**
      * Fetches the list of available series by frequency and their metadata.
@@ -87,7 +83,7 @@ class Client {
             frequency,
             function: 'SearchSeries',
         };
-        return this.request(query).then(parsers_1.parseSearchSeriesResponse);
+        return this.request(query).then(utils_1.parseSearchSeriesResponse);
     }
 }
 exports.Client = Client;

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-interface SeriesValue {
+export interface SeriesObservation {
     /**
      * Series observed date in DD-MM-YYYY format.
      */
@@ -12,7 +12,7 @@ interface SeriesValue {
      */
     statusCode: 'OK' | 'ND';
 }
-interface SeriesHistory {
+export interface SeriesHistory {
     /**
      * Series identifier.
      */
@@ -28,12 +28,12 @@ interface SeriesHistory {
     /**
      * List of series observed values.
      */
-    Obs: SeriesValue[];
+    Obs: SeriesObservation[];
 }
-type NullSeries = {
+export type NullSeries = {
     [key in keyof SeriesHistory]: null;
 };
-interface SeriesMetadata {
+export interface SeriesMetadata {
     /**
      * Series identifier.
      */
@@ -106,4 +106,3 @@ export type SearchSeriesResponse = ReadonlyArray<{
     updatedAt: string;
     createdAt: string;
 }>;
-export {};

package/dist/utils.d.ts

@@ -0,0 +1,17 @@
+import { ApiResponse, GetSeriesResponse, SearchSeriesResponse } from './types';
+/**
+ * Determines wether a given value can be parsed to a valid date.
+ */
+export declare function isValidDate(date: unknown): boolean;
+/**
+ * Reverses a date string from DD-MM-YYYY to YYYY-MM-DD format.
+ */
+export declare function reverseDate(date: string): string;
+/**
+ * Parses the GetSeries function API response.
+ */
+export declare function parseGetSeriesResponse<T extends ApiResponse>(response: T): GetSeriesResponse;
+/**
+ * Parses the SearchSeries function API response.
+ */
+export declare function parseSearchSeriesResponse<T extends ApiResponse>(response: T): SearchSeriesResponse;

package/dist/{helpers/parsers.js → utils.js}

@@ -1,18 +1,37 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseSearchSeriesResponse = exports.parseGetSeriesResponse = void 0;
-const reverse_date_1 = __importDefault(require("./reverse-date"));
-const errors_1 = require("../errors");
+exports.parseSearchSeriesResponse = exports.parseGetSeriesResponse = exports.reverseDate = exports.isValidDate = void 0;
+const errors_1 = require("./errors");
+/**
+ * Determines wether a given value can be parsed to a valid date.
+ */
+function isValidDate(date) {
+    if (typeof date === 'string') {
+        return !Number.isNaN(Date.parse(date));
+    }
+    if (date instanceof Date) {
+        return !Number.isNaN(date.getTime());
+    }
+    return false;
+}
+exports.isValidDate = isValidDate;
+/**
+ * Reverses a date string from DD-MM-YYYY to YYYY-MM-DD format.
+ */
+function reverseDate(date) {
+    return date.split('-').reverse().join('-');
+}
+exports.reverseDate = reverseDate;
+/**
+ * Parses the GetSeries function API response.
+ */
 function parseGetSeriesResponse(response) {
     if (response.Codigo !== 0) {
         switch (response.Codigo) {
             case errors_1.ErrorCodes.InvalidCredentials:
-                throw new errors_1.InvalidCredentialsError();
+                throw new errors_1.InvalidCredentialsError(response);
             case errors_1.ErrorCodes.InvalidSeries:
-                throw new errors_1.InvalidSeriesError();
+                throw new errors_1.InvalidSeriesError(response);
             default:
                 throw new errors_1.WebServiceError(response);
         }
@@ -21,19 +40,22 @@ function parseGetSeriesResponse(response) {
         seriesId: response.Series.seriesId || '',
         description: response.Series.descripIng || '',
         data: (response.Series.Obs || []).map((obs) => ({
-            date: (0, reverse_date_1.default)(obs.indexDateString),
+            date: reverseDate(obs.indexDateString),
             value: parseFloat(obs.value),
         })),
     };
 }
 exports.parseGetSeriesResponse = parseGetSeriesResponse;
+/**
+ * Parses the SearchSeries function API response.
+ */
 function parseSearchSeriesResponse(response) {
     if (response.Codigo !== 0) {
         switch (response.Codigo) {
             case errors_1.ErrorCodes.InvalidCredentials:
-                throw new errors_1.InvalidCredentialsError();
+                throw new errors_1.InvalidCredentialsError(response);
             case errors_1.ErrorCodes.InvalidFrequency:
-                throw new errors_1.InvalidFrequencyError();
+                throw new errors_1.InvalidFrequencyError(response);
             default:
                 throw new errors_1.WebServiceError(response);
         }
@@ -42,10 +64,10 @@ function parseSearchSeriesResponse(response) {
         seriesId: series.seriesId,
         frequency: series.frequencyCode,
         title: series.englishTitle,
-        firstObservedAt: (0, reverse_date_1.default)(series.firstObservation),
-        lastObservedAt: (0, reverse_date_1.default)(series.lastObservation),
-        updatedAt: (0, reverse_date_1.default)(series.updatedAt),
-        createdAt: (0, reverse_date_1.default)(series.createdAt),
+        firstObservedAt: reverseDate(series.firstObservation),
+        lastObservedAt: reverseDate(series.lastObservation),
+        updatedAt: reverseDate(series.updatedAt),
+        createdAt: reverseDate(series.createdAt),
     }));
 }
 exports.parseSearchSeriesResponse = parseSearchSeriesResponse;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bcchapi",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "API para acceder al Web Service del Banco Central de Chile.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/client.ts

@@ -1,8 +1,7 @@
 import * as querystring from 'node:querystring';
 import * as assert from 'node:assert/strict';
 import { GetSeriesResponse, SearchSeriesResponse, ApiResponse } from './types';
-import { parseGetSeriesResponse, parseSearchSeriesResponse } from './helpers/parsers';
-import isValidDate from './helpers/is-valid-date';
+import { isValidDate, parseGetSeriesResponse, parseSearchSeriesResponse } from './utils';
 
 export interface ClientConfig {
   /**

package/src/types.ts

@@ -1,4 +1,4 @@
-interface SeriesValue {
+export interface SeriesObservation {
   /**
    * Series observed date in DD-MM-YYYY format.
    */
@@ -13,7 +13,7 @@ interface SeriesValue {
   statusCode: 'OK' | 'ND';
 }
 
-interface SeriesHistory {
+export interface SeriesHistory {
   /**
    * Series identifier.
    */
@@ -29,14 +29,14 @@ interface SeriesHistory {
   /**
    * List of series observed values.
    */
-  Obs: SeriesValue[];
+  Obs: SeriesObservation[];
 }
 
-type NullSeries = {
+export type NullSeries = {
   [key in keyof SeriesHistory]: null;
 };
 
-interface SeriesMetadata {
+export interface SeriesMetadata {
   /**
    * Series identifier.
    */

package/src/{helpers/parsers.ts → utils.ts}

@@ -1,20 +1,49 @@
-import reverseDate from './reverse-date';
 import {
   ErrorCodes,
   InvalidFrequencyError,
   InvalidCredentialsError,
   InvalidSeriesError,
   WebServiceError,
-} from '../errors';
-import { ApiResponse, ErrorResponse, GetSeriesResponse, SearchSeriesResponse } from '../types';
+} from './errors';
+import {
+  ApiResponse,
+  SeriesObservation,
+  SeriesMetadata,
+  ErrorResponse,
+  GetSeriesResponse,
+  SearchSeriesResponse,
+} from './types';
+
+/**
+ * Determines wether a given value can be parsed to a valid date.
+ */
+export function isValidDate(date: unknown): boolean {
+  if (typeof date === 'string') {
+    return !Number.isNaN(Date.parse(date));
+  }
+  if (date instanceof Date) {
+    return !Number.isNaN(date.getTime());
+  }
+  return false;
+}
+
+/**
+ * Reverses a date string from DD-MM-YYYY to YYYY-MM-DD format.
+ */
+export function reverseDate(date: string): string {
+  return date.split('-').reverse().join('-');
+}
 
+/**
+ * Parses the GetSeries function API response.
+ */
 export function parseGetSeriesResponse<T extends ApiResponse>(response: T): GetSeriesResponse {
   if (response.Codigo !== 0) {
     switch (response.Codigo) {
       case ErrorCodes.InvalidCredentials:
-        throw new InvalidCredentialsError();
+        throw new InvalidCredentialsError(response as ApiResponse as ErrorResponse);
       case ErrorCodes.InvalidSeries:
-        throw new InvalidSeriesError();
+        throw new InvalidSeriesError(response as ApiResponse as ErrorResponse);
       default:
         throw new WebServiceError(response as ApiResponse as ErrorResponse);
     }
@@ -23,28 +52,31 @@ export function parseGetSeriesResponse<T extends ApiResponse>(response: T): GetS
   return {
     seriesId: response.Series.seriesId || '',
     description: response.Series.descripIng || '',
-    data: (response.Series.Obs || []).map((obs) => ({
+    data: (response.Series.Obs || []).map((obs: SeriesObservation) => ({
       date: reverseDate(obs.indexDateString),
       value: parseFloat(obs.value),
     })),
   };
 }
 
+/**
+ * Parses the SearchSeries function API response.
+ */
 export function parseSearchSeriesResponse<T extends ApiResponse>(
   response: T,
 ): SearchSeriesResponse {
   if (response.Codigo !== 0) {
     switch (response.Codigo) {
       case ErrorCodes.InvalidCredentials:
-        throw new InvalidCredentialsError();
+        throw new InvalidCredentialsError(response as ApiResponse as ErrorResponse);
       case ErrorCodes.InvalidFrequency:
-        throw new InvalidFrequencyError();
+        throw new InvalidFrequencyError(response as ApiResponse as ErrorResponse);
       default:
         throw new WebServiceError(response as ApiResponse as ErrorResponse);
     }
   }
 
-  return response.SeriesInfos.map((series) => ({
+  return response.SeriesInfos.map((series: SeriesMetadata) => ({
     seriesId: series.seriesId,
     frequency: series.frequencyCode,
     title: series.englishTitle,

package/test/client.test.ts

@@ -6,9 +6,9 @@ import {
   InvalidSeriesError,
   InvalidFrequencyError,
 } from '../src';
+import { reverseDate } from '../src/utils';
 import fetchMock from './mocks/fetch.mock';
 import fixtures from './fixtures';
-import reverseDate from '../src/helpers/reverse-date';
 
 const fetchSpy = vi.spyOn(global, 'fetch').mockImplementation(fetchMock);
 

package/test/mocks/fetch.mock.ts

@@ -1,5 +1,5 @@
 import { Frequency } from '../../src/client';
-import reverseDate from '../../src/helpers/reverse-date';
+import { reverseDate } from '../../src/utils';
 import fixtures from '../fixtures';
 
 export default (input: string | URL | Request) => {

package/test/{helpers → utils}/is-valid-date.test.ts

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import isValidDate from '../../src/helpers/is-valid-date';
+import { isValidDate } from '../../src/utils';
 
 describe('isValidDate', () => {
   it('should return true if the date is valid', () => {

package/test/{helpers → utils}/parse-get-series.test.ts

@@ -1,6 +1,6 @@
 import { describe, it, expect } from 'vitest';
 import * as Errors from '../../src/errors';
-import { parseGetSeriesResponse } from '../../src/helpers/parsers';
+import { parseGetSeriesResponse } from '../../src/utils';
 import { ApiResponse } from '../../src/types';
 import fixtures from '../fixtures';
 

package/test/{helpers → utils}/parse-search-series.test.ts

@@ -1,7 +1,7 @@
 import { describe, it, expect } from 'vitest';
 import * as Errors from '../../src/errors';
 import { ApiResponse } from '../../src/types';
-import { parseSearchSeriesResponse } from '../../src/helpers/parsers';
+import { parseSearchSeriesResponse } from '../../src/utils';
 import fixtures from '../fixtures';
 
 describe('parseSearchSeriesResponse', () => {

package/test/{helpers → utils}/reverse-date.test.ts

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import reverseDate from '../../src/helpers/reverse-date';
+import { reverseDate } from '../../src/utils';
 
 describe('reverseDate', () => {
   it('should reverse correctly a date in DD-MM-YYYY format', () => {

package/dist/helpers/is-valid-date.d.ts

@@ -1 +0,0 @@
-export default function isValidDate(date: unknown): boolean;

package/dist/helpers/is-valid-date.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-function isValidDate(date) {
-    if (typeof date === 'string') {
-        return !Number.isNaN(Date.parse(date));
-    }
-    if (date instanceof Date) {
-        return !Number.isNaN(date.getTime());
-    }
-    return false;
-}
-exports.default = isValidDate;

package/dist/helpers/parsers.d.ts

@@ -1,3 +0,0 @@
-import { ApiResponse, GetSeriesResponse, SearchSeriesResponse } from '../types';
-export declare function parseGetSeriesResponse<T extends ApiResponse>(response: T): GetSeriesResponse;
-export declare function parseSearchSeriesResponse<T extends ApiResponse>(response: T): SearchSeriesResponse;

package/dist/helpers/reverse-date.d.ts

@@ -1 +0,0 @@
-export default function reverseDate(date: string): string;

package/dist/helpers/reverse-date.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-function reverseDate(date) {
-    return date.split('-').reverse().join('-');
-}
-exports.default = reverseDate;

package/src/helpers/is-valid-date.ts

@@ -1,9 +0,0 @@
-export default function isValidDate(date: unknown): boolean {
-  if (typeof date === 'string') {
-    return !Number.isNaN(Date.parse(date));
-  }
-  if (date instanceof Date) {
-    return !Number.isNaN(date.getTime());
-  }
-  return false;
-}

package/src/helpers/reverse-date.ts

@@ -1,3 +0,0 @@
-export default function reverseDate(date: string): string {
-  return date.split('-').reverse().join('-');
-}