rocket-launch-live-client 0.2.1 → 1.0.0

package/lib/esm/Client.js

@@ -1,11 +1,15 @@
-import { RLLEndPoint, } from "./types/application";
-import { fetcher } from "./fetcher";
-import { apiKeyValidator, optionsValidator, queryOptionsValidator, } from "./utils";
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RLLClient = void 0;
+const application_1 = require("./types/application");
+const fetcher_1 = require("./fetcher");
+const utils_1 = require("./utils");
+const Watcher_1 = require("./Watcher");
 /**
  * Class representing a RocketLaunch.Live client
  * @class
  */
-export class RLLClient {
+class RLLClient {
     apiKey;
     config = {
         keyInQueryParams: false,
@@ -21,12 +25,12 @@ export class RLLClient {
     constructor(apiKey, options) {
         // Validate API Key is a valid UUID format
         // Constructor throws if not
-        this.apiKey = apiKeyValidator(apiKey);
+        this.apiKey = (0, utils_1.apiKeyValidator)(apiKey);
         if (!options) {
             return;
         }
         // Validate Options with warnings or throws
-        optionsValidator(options);
+        (0, utils_1.optionsValidator)(options);
         if (options.keyInQueryParams) {
             this.config.keyInQueryParams = options.keyInQueryParams;
         }
@@ -44,7 +48,20 @@ export class RLLClient {
      * @returns {Promise<T>}
      */
     query(endpoint, params) {
-        return fetcher(this.apiKey, endpoint, params, this.config.keyInQueryParams);
+        return (0, fetcher_1.fetcher)(this.apiKey, endpoint, params, this.config.keyInQueryParams);
+    }
+    /**
+     * Instantiate a new RLL Watcher which will continually query the API for changes to the launches endpoint
+     *
+     * @public
+     *
+     * @param {number} interval - Interval in minutes to query the API for changes. Defaults to 5 minutes, cannot be less than 1 minute
+     * @param {RLLQueryConfig.Launches} options - Query options, same as calling the launches method
+     *
+     * @returns {RLLWatcher}
+     */
+    watch(interval, options) {
+        return new Watcher_1.RLLWatcher((params) => this.query(application_1.RLLEndPoint.LAUNCHES, params), interval, options);
     }
     /**
      * Fetch launch companies
@@ -63,10 +80,11 @@ export class RLLClient {
      *
      * @example
      *
-     * const response = client.companies({ country_code: "US" })
+     * const response = await client.companies({ country_code: "US" })
      */
     companies(options) {
-        return queryOptionsValidator(RLLEndPoint.COMPANIES, options).then((params) => this.query(RLLEndPoint.COMPANIES, params));
+        const params = (0, utils_1.queryOptionsValidator)(application_1.RLLEndPoint.COMPANIES, options);
+        return this.query(application_1.RLLEndPoint.COMPANIES, params);
     }
     /**
      * Fetch launches
@@ -95,10 +113,11 @@ export class RLLClient {
      *
      * @example
      *
-     * const response = client.launches({ after_date: new Date("2022-10-10") })
+     * const response = await client.launches({ after_date: new Date("2022-10-10") })
      */
     launches(options) {
-        return queryOptionsValidator(RLLEndPoint.LAUNCHES, options).then((params) => this.query(RLLEndPoint.LAUNCHES, params));
+        const params = (0, utils_1.queryOptionsValidator)(application_1.RLLEndPoint.LAUNCHES, options);
+        return this.query(application_1.RLLEndPoint.LAUNCHES, params);
     }
     /**
      * Fetch launch locations
@@ -117,10 +136,11 @@ export class RLLClient {
      *
      * @example
      *
-     * const response = client.locations({ country_code: "US" })
+     * const response = await client.locations({ country_code: "US" })
      */
     locations(options) {
-        return queryOptionsValidator(RLLEndPoint.LOCATIONS, options).then((params) => this.query(RLLEndPoint.LOCATIONS, params));
+        const params = (0, utils_1.queryOptionsValidator)(application_1.RLLEndPoint.LOCATIONS, options);
+        return this.query(application_1.RLLEndPoint.LOCATIONS, params);
     }
     /**
      * Fetch launch Missions
@@ -137,10 +157,11 @@ export class RLLClient {
      *
      * @example
      *
-     * const response = client.missions({ name: "Mars 2020" })
+     * const response = await client.missions({ name: "Mars 2020" })
      */
     missions(options) {
-        return queryOptionsValidator(RLLEndPoint.MISSIONS, options).then((params) => this.query(RLLEndPoint.MISSIONS, params));
+        const params = (0, utils_1.queryOptionsValidator)(application_1.RLLEndPoint.MISSIONS, options);
+        return this.query(application_1.RLLEndPoint.MISSIONS, params);
     }
     /**
      * Fetch launch pads
@@ -159,10 +180,11 @@ export class RLLClient {
      *
      * @example
      *
-     * const response = client.pads({ country_code: "US" })
+     * const response = await client.pads({ country_code: "US" })
      */
     pads(options) {
-        return queryOptionsValidator(RLLEndPoint.PADS, options).then((params) => this.query(RLLEndPoint.PADS, params));
+        const params = (0, utils_1.queryOptionsValidator)(application_1.RLLEndPoint.PADS, options);
+        return this.query(application_1.RLLEndPoint.PADS, params);
     }
     /**
      * Fetch launch tags
@@ -179,10 +201,11 @@ export class RLLClient {
      *
      * @example
      *
-     * const response = client.tags({ text: "Crewed" })
+     * const response = await client.tags({ text: "Crewed" })
      */
     tags(options) {
-        return queryOptionsValidator(RLLEndPoint.TAGS, options).then((params) => this.query(RLLEndPoint.TAGS, params));
+        const params = (0, utils_1.queryOptionsValidator)(application_1.RLLEndPoint.TAGS, options);
+        return this.query(application_1.RLLEndPoint.TAGS, params);
     }
     /**
      * Fetch launch Vehicles
@@ -199,9 +222,11 @@ export class RLLClient {
      *
      * @example
      *
-     * const response = client.vehicles({ name: "Falcon 9" })
+     * const response = await client.vehicles({ name: "Falcon 9" })
      */
     vehicles(options) {
-        return queryOptionsValidator(RLLEndPoint.VEHICLES, options).then((params) => this.query(RLLEndPoint.VEHICLES, params));
+        const params = (0, utils_1.queryOptionsValidator)(application_1.RLLEndPoint.VEHICLES, options);
+        return this.query(application_1.RLLEndPoint.VEHICLES, params);
     }
 }
+exports.RLLClient = RLLClient;

package/lib/esm/Watcher.js

@@ -0,0 +1,182 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RLLWatcher = void 0;
+const events_1 = __importDefault(require("events"));
+const application_1 = require("./types/application");
+const utils_1 = require("./utils");
+const DEFAULT_INTERVAL_IN_MINS = 5;
+const MS_IN_MIN = 60000;
+const intervalValidator = (interval) => {
+    if (typeof interval !== "number" && typeof interval !== "string") {
+        (0, utils_1.error)("RLLWatcher interval must be a number.");
+        return DEFAULT_INTERVAL_IN_MINS;
+    }
+    if (typeof interval === "string" &&
+        (isNaN(Number(interval)) || interval === "")) {
+        (0, utils_1.error)("RLLWatcher interval must be a number.", "type");
+        return DEFAULT_INTERVAL_IN_MINS;
+    }
+    const typedInterval = Number(interval);
+    if (typedInterval <= 0) {
+        (0, utils_1.error)("RLLWatcher interval cannot be a negative number or zero. Watcher intervals should be greater than or equal to 1 minute.");
+        return DEFAULT_INTERVAL_IN_MINS;
+    }
+    if (typedInterval < 1) {
+        (0, utils_1.warn)("RLLWatcher does not accept intervals less than 1. Your watcher will default to 5 minute intervals unless corrected.");
+        return DEFAULT_INTERVAL_IN_MINS;
+    }
+    return typedInterval;
+};
+/**
+ * Class representing a RocketLaunch.Live Client Watcher
+ * @class
+ */
+class RLLWatcher extends events_1.default {
+    _untypedOn;
+    _untypedEmit;
+    last_call;
+    launches = new Map();
+    interval;
+    params;
+    timer;
+    fetcher;
+    /**
+     * Create a new RocketLaunch.live Client Watcher
+     *
+     * @param {function(params: URLSearchParams): Promise<RLLResponse<RLLEntity.Launch[]>>} fetcher - fetcher function to make API calls
+     * @param {number | string} [interval] - Optional Client Configuration options
+     * @param {Object} [options] - Launch Search Options
+     * @param {number | string} options.id - Launch id
+     * @param {number | string} options.page - Page number of results
+     * @param {string} options.cospar_id - Launch COSPAR ID (ie. 2022-123)
+     * @param {Date | string} options.before_date - Only return launches before this date
+     * @param {Date | string} options.after_date - Only return launches after this date
+     * @param {Date | string} options.modified_since - Only return launches with API changes after this date
+     * @param {number | string} options.location_id - Launches from this Location
+     * @param {number | string} options.pad_id - Launches from this Pad
+     * @param {number | string} options.provider_id - Launches from this Company
+     * @param {number | string} options.tag_id - Launches with this Tag
+     * @param {number | string} options.vehicle_id - Launches on this Vehicle
+     * @param {ISO3166Alpha2.StateCodeUS} options.state_abbr - ISO 3166 Alpha 2 US State Code
+     * @param {ISO3166Alpha2.CountryCode} options.country_code - ISO 3166 Alpha 2 Country Code
+     * @param {number | string} options.search - Launches matching this search string
+     * @param {number | string} options.slug - Launches matching this unique slug
+     *
+     */
+    constructor(fetcher, interval = DEFAULT_INTERVAL_IN_MINS, options) {
+        super();
+        // Reassign default Event Emitter methods
+        this._untypedOn = this.on;
+        this._untypedEmit = this.emit;
+        // Methord Overide for type safety
+        this.on = (event, listener) => this._untypedOn(event, listener);
+        this.emit = (event, ...args) => this._untypedEmit(event, ...args);
+        this.last_call = new Date();
+        this.fetcher = fetcher;
+        this.interval = intervalValidator(interval);
+        this.params = (0, utils_1.queryOptionsValidator)(application_1.RLLEndPoint.LAUNCHES, options);
+        // ignore any limit params as these cause unnecessary API calls and do not serve the Watcher role
+        this.params.delete("limit");
+    }
+    /**
+     * Recursive API Caller to iterate through pages
+     *
+     * @private
+     * @function
+     *
+     * @param {URLSearchParams} params - Search parameters
+     * @param {function(results: RLLResponse<RLLEntity.Launch[]>)} callback - To execute on each page
+     *
+     * @returns {Promise<void>}
+     */
+    recursivelyFetch = (params, callback) => {
+        let page = 1;
+        const recursiveFetcher = () => {
+            this.emit("call", params);
+            return this.fetcher(params).then((results) => {
+                callback(results);
+                if (results.last_page > page) {
+                    page++;
+                    params.set("page", page.toString());
+                    return recursiveFetcher();
+                }
+                return;
+            });
+        };
+        return recursiveFetcher();
+    };
+    /**
+     * Query wrapper to trigger events
+     *
+     * @private
+     * @function
+     *
+     * @returns {void}
+     */
+    query() {
+        const notify = (response) => {
+            for (const changedLaunch of response.result) {
+                const { id } = changedLaunch;
+                const oldLaunch = this.launches.get(id);
+                if (oldLaunch) {
+                    this.emit("change", oldLaunch, changedLaunch);
+                }
+                else {
+                    this.emit("new", changedLaunch);
+                }
+                this.launches.set(changedLaunch.id, changedLaunch);
+            }
+        };
+        this.params.set("modified_since", (0, utils_1.formatToRLLISODate)(this.last_call));
+        this.recursivelyFetch(new URLSearchParams(this.params), notify)
+            .then(() => {
+            this.last_call = new Date();
+        })
+            .catch((err) => {
+            this.emit("error", err);
+        });
+    }
+    /**
+     * Begin monitoring API using the configured query parameters.
+     *
+     * @public
+     * @function
+     *
+     * @returns {void}
+     */
+    start() {
+        const buildCache = (response) => {
+            for (const launch of response.result) {
+                this.launches.set(launch.id, launch);
+            }
+        };
+        this.recursivelyFetch(new URLSearchParams(this.params), buildCache)
+            .then(() => {
+            this.emit("ready", this.launches);
+            this.last_call = new Date();
+            this.timer = setInterval(() => {
+                this.query();
+            }, this.interval * MS_IN_MIN);
+        })
+            .catch((err) => {
+            this.emit("init_error", err);
+        });
+    }
+    /**
+     * Stop monitoring API
+     *
+     * @public
+     * @function
+     *
+     * @returns {void}
+     */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+        }
+    }
+}
+exports.RLLWatcher = RLLWatcher;

package/lib/esm/fetcher.js

@@ -1,6 +1,12 @@
-import https from "https";
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetcher = void 0;
+const https_1 = __importDefault(require("https"));
 const BASE_URL = "https://fdo.rocketlaunch.live";
-export const fetcher = (apiKey, endpoint, params, keyInQueryParams) => {
+const fetcher = (apiKey, endpoint, params, keyInQueryParams) => {
     const url = new URL("json/" + endpoint, BASE_URL);
     let headers;
     if (keyInQueryParams) {
@@ -12,28 +18,36 @@ export const fetcher = (apiKey, endpoint, params, keyInQueryParams) => {
     params.forEach((v, k) => url.searchParams.set(k, v));
     return query(url, headers);
 };
+exports.fetcher = fetcher;
 const query = (url, headers) => {
     return new Promise((resolve, reject) => {
-        const req = https.get(url, { headers }, (res) => {
+        const req = https_1.default.get(url, { headers }, (res) => {
             let data = [];
             res.on("data", (chunk) => data.push(chunk));
             res.on("end", () => {
+                const response = Buffer.concat(data).toString();
                 if (res.statusCode === 200) {
-                    const response = Buffer.concat(data).toString();
                     resolve(JSON.parse(response));
                 }
-                else if (res.statusCode === 404) {
-                    reject({
-                        error: "Resource not found",
-                        statusCode: 404,
-                        message: "The server returned a 404 Not Found response. Check that your API key is valid, and that you are not requesting a page number beyond the available results.",
-                    });
-                }
                 else {
-                    reject(res);
+                    const error = {
+                        error: "API Call Failed",
+                        statusCode: res.statusCode ?? null,
+                        message: "RLLC recieved a response from the server but it did not complete as expected.",
+                        server_response: JSON.parse(response),
+                    };
+                    reject(error);
                 }
             });
         });
-        req.on("error", reject);
+        req.on("error", () => {
+            const error = {
+                error: "Unknown error",
+                statusCode: null,
+                message: "RLLC recieved an unknown error. This usually means that the HTTP request did not complete",
+                server_response: null,
+            };
+            reject(error);
+        });
     });
 };

package/lib/esm/index.mjs

@@ -1,6 +1,14 @@
-import { RLLClient } from "./Client";
-export { RLLEndPoint, RLLEntity, } from "./types/application";
-export { RLLClient } from "./Client";
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rllc = exports.RLLWatcher = exports.RLLClient = exports.RLLEntity = exports.RLLEndPoint = void 0;
+const Client_1 = require("./Client");
+var application_1 = require("./types/application");
+Object.defineProperty(exports, "RLLEndPoint", { enumerable: true, get: function () { return application_1.RLLEndPoint; } });
+Object.defineProperty(exports, "RLLEntity", { enumerable: true, get: function () { return application_1.RLLEntity; } });
+var Client_2 = require("./Client");
+Object.defineProperty(exports, "RLLClient", { enumerable: true, get: function () { return Client_2.RLLClient; } });
+var Watcher_1 = require("./Watcher");
+Object.defineProperty(exports, "RLLWatcher", { enumerable: true, get: function () { return Watcher_1.RLLWatcher; } });
 /**
  * Generate a RocketLaunch.Live client
  *
@@ -18,4 +26,5 @@ export { RLLClient } from "./Client";
  * const MY_KEY = process.env.ROCKETLAUNCH_LIVE_API_KEY
  * const client = rllc(MY_KEY, { keyInQueryParams: true })
  */
-export const rllc = (apiKey, options) => new RLLClient(apiKey, options);
+const rllc = (apiKey, options) => new Client_1.RLLClient(apiKey, options);
+exports.rllc = rllc;

package/lib/esm/types/Client.d.ts

@@ -1,4 +1,5 @@
 import { RLLClientOptions, RLLEntity, RLLQueryConfig, RLLResponse } from "./types/application";
+import { RLLWatcher } from "./Watcher";
 /**
  * Class representing a RocketLaunch.Live client
  * @class
@@ -28,6 +29,17 @@ export declare class RLLClient {
      * @returns {Promise<T>}
      */
     private query;
+    /**
+     * Instantiate a new RLL Watcher which will continually query the API for changes to the launches endpoint
+     *
+     * @public
+     *
+     * @param {number} interval - Interval in minutes to query the API for changes. Defaults to 5 minutes, cannot be less than 1 minute
+     * @param {RLLQueryConfig.Launches} options - Query options, same as calling the launches method
+     *
+     * @returns {RLLWatcher}
+     */
+    watch(interval?: number | string, options?: RLLQueryConfig.Launches): RLLWatcher;
     /**
      * Fetch launch companies
      *
@@ -45,7 +57,7 @@ export declare class RLLClient {
      *
      * @example
      *
-     * const response = client.companies({ country_code: "US" })
+     * const response = await client.companies({ country_code: "US" })
      */
     companies(options?: RLLQueryConfig.Companies): Promise<RLLResponse<RLLEntity.Company[]>>;
     /**
@@ -75,7 +87,7 @@ export declare class RLLClient {
      *
      * @example
      *
-     * const response = client.launches({ after_date: new Date("2022-10-10") })
+     * const response = await client.launches({ after_date: new Date("2022-10-10") })
      */
     launches(options?: RLLQueryConfig.Launches): Promise<RLLResponse<RLLEntity.Launch[]>>;
     /**
@@ -95,7 +107,7 @@ export declare class RLLClient {
      *
      * @example
      *
-     * const response = client.locations({ country_code: "US" })
+     * const response = await client.locations({ country_code: "US" })
      */
     locations(options?: RLLQueryConfig.Locations): Promise<RLLResponse<RLLEntity.Location[]>>;
     /**
@@ -113,7 +125,7 @@ export declare class RLLClient {
      *
      * @example
      *
-     * const response = client.missions({ name: "Mars 2020" })
+     * const response = await client.missions({ name: "Mars 2020" })
      */
     missions(options?: RLLQueryConfig.Missions): Promise<RLLResponse<RLLEntity.Mission[]>>;
     /**
@@ -133,7 +145,7 @@ export declare class RLLClient {
      *
      * @example
      *
-     * const response = client.pads({ country_code: "US" })
+     * const response = await client.pads({ country_code: "US" })
      */
     pads(options?: RLLQueryConfig.Pads): Promise<RLLResponse<RLLEntity.Pad[]>>;
     /**
@@ -151,7 +163,7 @@ export declare class RLLClient {
      *
      * @example
      *
-     * const response = client.tags({ text: "Crewed" })
+     * const response = await client.tags({ text: "Crewed" })
      */
     tags(options?: RLLQueryConfig.Tags): Promise<RLLResponse<RLLEntity.Tag[]>>;
     /**
@@ -169,7 +181,7 @@ export declare class RLLClient {
      *
      * @example
      *
-     * const response = client.vehicles({ name: "Falcon 9" })
+     * const response = await client.vehicles({ name: "Falcon 9" })
      */
     vehicles(options?: RLLQueryConfig.Vehicles): Promise<RLLResponse<RLLEntity.Vehicle[]>>;
 }

package/lib/esm/types/Client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../../../src/Client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAEhB,SAAS,EACT,cAAc,EACd,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAQ7B;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAEZ;IAEF;;;;;;;OAOG;gBACS,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAiBtD;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,KAAK;IASb;;;;;;;;;;;;;;;;;;OAkBG;IACI,SAAS,CACd,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,GACjC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IAU5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACI,QAAQ,CACb,OAAO,CAAC,EAAE,cAAc,CAAC,QAAQ,GAChC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAM3C;;;;;;;;;;;;;;;;;;OAkBG;IACI,SAAS,CACd,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,GACjC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;IAU7C;;;;;;;;;;;;;;;;OAgBG;IACI,QAAQ,CACb,OAAO,CAAC,EAAE,cAAc,CAAC,QAAQ,GAChC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IAM5C;;;;;;;;;;;;;;;;;;OAkBG;IACI,IAAI,CACT,OAAO,CAAC,EAAE,cAAc,CAAC,IAAI,GAC5B,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC;IAMxC;;;;;;;;;;;;;;;;OAgBG;IACI,IAAI,CACT,OAAO,CAAC,EAAE,cAAc,CAAC,IAAI,GAC5B,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC;IAMxC;;;;;;;;;;;;;;;;OAgBG;IACI,QAAQ,CACb,OAAO,CAAC,EAAE,cAAc,CAAC,QAAQ,GAChC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;CAK7C"}
+{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../../../src/Client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAEhB,SAAS,EACT,cAAc,EACd,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAO7B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAEZ;IAEF;;;;;;;OAOG;gBACS,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAiBtD;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,KAAK;IASb;;;;;;;;;OASG;IACI,KAAK,CACV,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAC1B,OAAO,CAAC,EAAE,cAAc,CAAC,QAAQ,GAChC,UAAU;IAYb;;;;;;;;;;;;;;;;;;OAkBG;IACI,SAAS,CACd,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,GACjC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IAQ5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACI,QAAQ,CACb,OAAO,CAAC,EAAE,cAAc,CAAC,QAAQ,GAChC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAQ3C;;;;;;;;;;;;;;;;;;OAkBG;IACI,SAAS,CACd,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,GACjC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;IAQ7C;;;;;;;;;;;;;;;;OAgBG;IACI,QAAQ,CACb,OAAO,CAAC,EAAE,cAAc,CAAC,QAAQ,GAChC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IAQ5C;;;;;;;;;;;;;;;;;;OAkBG;IACI,IAAI,CACT,OAAO,CAAC,EAAE,cAAc,CAAC,IAAI,GAC5B,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC;IAKxC;;;;;;;;;;;;;;;;OAgBG;IACI,IAAI,CACT,OAAO,CAAC,EAAE,cAAc,CAAC,IAAI,GAC5B,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC;IAKxC;;;;;;;;;;;;;;;;OAgBG;IACI,QAAQ,CACb,OAAO,CAAC,EAAE,cAAc,CAAC,QAAQ,GAChC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;CAO7C"}

package/lib/esm/types/Watcher.d.ts

@@ -0,0 +1,81 @@
+/// <reference types="node" />
+import EventEmitter from "events";
+import { RLLEntity, RLLQueryConfig, RLLResponse } from "./types/application";
+/**
+ * Class representing a RocketLaunch.Live Client Watcher
+ * @class
+ */
+export declare class RLLWatcher extends EventEmitter {
+    private _untypedOn;
+    private _untypedEmit;
+    private last_call;
+    launches: Map<number, RLLEntity.Launch>;
+    private interval;
+    private params;
+    private timer;
+    private fetcher;
+    /**
+     * Create a new RocketLaunch.live Client Watcher
+     *
+     * @param {function(params: URLSearchParams): Promise<RLLResponse<RLLEntity.Launch[]>>} fetcher - fetcher function to make API calls
+     * @param {number | string} [interval] - Optional Client Configuration options
+     * @param {Object} [options] - Launch Search Options
+     * @param {number | string} options.id - Launch id
+     * @param {number | string} options.page - Page number of results
+     * @param {string} options.cospar_id - Launch COSPAR ID (ie. 2022-123)
+     * @param {Date | string} options.before_date - Only return launches before this date
+     * @param {Date | string} options.after_date - Only return launches after this date
+     * @param {Date | string} options.modified_since - Only return launches with API changes after this date
+     * @param {number | string} options.location_id - Launches from this Location
+     * @param {number | string} options.pad_id - Launches from this Pad
+     * @param {number | string} options.provider_id - Launches from this Company
+     * @param {number | string} options.tag_id - Launches with this Tag
+     * @param {number | string} options.vehicle_id - Launches on this Vehicle
+     * @param {ISO3166Alpha2.StateCodeUS} options.state_abbr - ISO 3166 Alpha 2 US State Code
+     * @param {ISO3166Alpha2.CountryCode} options.country_code - ISO 3166 Alpha 2 Country Code
+     * @param {number | string} options.search - Launches matching this search string
+     * @param {number | string} options.slug - Launches matching this unique slug
+     *
+     */
+    constructor(fetcher: (params: URLSearchParams) => Promise<RLLResponse<RLLEntity.Launch[]>>, interval?: number | string, options?: RLLQueryConfig.Launches);
+    /**
+     * Recursive API Caller to iterate through pages
+     *
+     * @private
+     * @function
+     *
+     * @param {URLSearchParams} params - Search parameters
+     * @param {function(results: RLLResponse<RLLEntity.Launch[]>)} callback - To execute on each page
+     *
+     * @returns {Promise<void>}
+     */
+    private recursivelyFetch;
+    /**
+     * Query wrapper to trigger events
+     *
+     * @private
+     * @function
+     *
+     * @returns {void}
+     */
+    private query;
+    /**
+     * Begin monitoring API using the configured query parameters.
+     *
+     * @public
+     * @function
+     *
+     * @returns {void}
+     */
+    start(): void;
+    /**
+     * Stop monitoring API
+     *
+     * @public
+     * @function
+     *
+     * @returns {void}
+     */
+    stop(): void;
+}
+//# sourceMappingURL=Watcher.d.ts.map

package/lib/esm/types/Watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Watcher.d.ts","sourceRoot":"","sources":["../../../src/Watcher.ts"],"names":[],"mappings":";AAAA,OAAO,YAAY,MAAM,QAAQ,CAAC;AAClC,OAAO,EAEL,SAAS,EAET,cAAc,EAEd,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAqD7B;;;GAGG;AACH,qBAAa,UAAW,SAAQ,YAAY;IAC1C,OAAO,CAAC,UAAU,CAGR;IACV,OAAO,CAAC,YAAY,CAA0D;IAC9E,OAAO,CAAC,SAAS,CAAO;IACjB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAa;IAC3D,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,OAAO,CAE+B;IAE9C;;;;;;;;;;;;;;;;;;;;;;OAsBG;gBAED,OAAO,EAAE,CACP,MAAM,EAAE,eAAe,KACpB,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,EAC7C,QAAQ,GAAE,MAAM,GAAG,MAAiC,EACpD,OAAO,CAAC,EAAE,cAAc,CAAC,QAAQ;IA4BnC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,gBAAgB,CAsBtB;IAEF;;;;;;;OAOG;IACH,OAAO,CAAC,KAAK;IAyBb;;;;;;;OAOG;IACI,KAAK,IAAI,IAAI;IAoBpB;;;;;;;OAOG;IACI,IAAI,IAAI,IAAI;CAKpB"}

package/lib/esm/types/application.js

@@ -1,4 +1,7 @@
-export var RLLEndPoint;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RLLQueryParams = exports.RLLEntity = exports.RLLEndPoint = void 0;
+var RLLEndPoint;
 (function (RLLEndPoint) {
     RLLEndPoint["COMPANIES"] = "companies";
     RLLEndPoint["LAUNCHES"] = "launches";
@@ -7,8 +10,8 @@ export var RLLEndPoint;
     RLLEndPoint["PADS"] = "pads";
     RLLEndPoint["TAGS"] = "tags";
     RLLEndPoint["VEHICLES"] = "vehicles";
-})(RLLEndPoint || (RLLEndPoint = {}));
-export var RLLEntity;
+})(RLLEndPoint || (exports.RLLEndPoint = RLLEndPoint = {}));
+var RLLEntity;
 (function (RLLEntity) {
     let LaunchResult;
     (function (LaunchResult) {
@@ -18,8 +21,8 @@ export var RLLEntity;
         LaunchResult[LaunchResult["PARTIAL_FAILURE"] = 2] = "PARTIAL_FAILURE";
         LaunchResult[LaunchResult["IN_FLIGHT_ABORT_CREWED"] = 3] = "IN_FLIGHT_ABORT_CREWED";
     })(LaunchResult = RLLEntity.LaunchResult || (RLLEntity.LaunchResult = {}));
-})(RLLEntity || (RLLEntity = {}));
-export const RLLQueryParams = {
+})(RLLEntity || (exports.RLLEntity = RLLEntity = {}));
+exports.RLLQueryParams = {
     id: true,
     page: true,
     name: true,
@@ -38,4 +41,6 @@ export const RLLQueryParams = {
     search: true,
     slug: true,
     text: true,
+    limit: true,
+    direction: true,
 };

package/lib/esm/types/fetcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../../src/fetcher.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,OAAO,cACV,MAAM,YACJ,MAAM,UACR,eAAe,oBACL,OAAO,eAc1B,CAAC"}
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../../src/fetcher.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,OAAO,cACV,MAAM,YACJ,MAAM,UACR,eAAe,oBACL,OAAO,eAc1B,CAAC"}

package/lib/esm/types/index.d.ts

@@ -1,8 +1,9 @@
 import { RLLClient } from "./Client";
 import { RLLClientOptions } from "./types/application";
-export { RLLEndPoint, RLLResponse, RLLClientOptions, RLLQueryConfig, RLLEntity, } from "./types/application";
+export { RLLEndPoint, RLLResponse, RLLClientOptions, RLLQueryConfig, RLLEntity, RLLError, } from "./types/application";
 export { ISO3166Alpha2 } from "./types/standards";
 export { RLLClient } from "./Client";
+export { RLLWatcher } from "./Watcher";
 /**
  * Generate a RocketLaunch.Live client
  *

package/lib/esm/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EACL,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,SAAS,GACV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,IAAI,WAAY,MAAM,YAAY,gBAAgB,KAAG,SAClC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EACL,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,IAAI,WAAY,MAAM,YAAY,gBAAgB,KAAG,SAClC,CAAC"}