rocket-launch-live-client 0.2.0 → 0.3.0

package/lib/esm/Client.js

@@ -1,6 +1,7 @@
 import { RLLEndPoint, } from "./types/application";
 import { fetcher } from "./fetcher";
 import { apiKeyValidator, optionsValidator, queryOptionsValidator, } from "./utils";
+import { RLLWatcher } from "./Watcher";
 /**
  * Class representing a RocketLaunch.Live client
  * @class
@@ -21,8 +22,7 @@ export class RLLClient {
     constructor(apiKey, options) {
         // Validate API Key is a valid UUID format
         // Constructor throws if not
-        apiKeyValidator(apiKey);
-        this.apiKey = apiKey;
+        this.apiKey = apiKeyValidator(apiKey);
         if (!options) {
             return;
         }
@@ -47,6 +47,19 @@ export class RLLClient {
     query(endpoint, params) {
         return 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 RLLWatcher((params) => this.query(RLLEndPoint.LAUNCHES, params), interval, options);
+    }
     /**
      * Fetch launch companies
      *
@@ -64,10 +77,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 = queryOptionsValidator(RLLEndPoint.COMPANIES, options);
+        return this.query(RLLEndPoint.COMPANIES, params);
     }
     /**
      * Fetch launches
@@ -96,10 +110,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 = queryOptionsValidator(RLLEndPoint.LAUNCHES, options);
+        return this.query(RLLEndPoint.LAUNCHES, params);
     }
     /**
      * Fetch launch locations
@@ -118,10 +133,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 = queryOptionsValidator(RLLEndPoint.LOCATIONS, options);
+        return this.query(RLLEndPoint.LOCATIONS, params);
     }
     /**
      * Fetch launch Missions
@@ -138,10 +154,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 = queryOptionsValidator(RLLEndPoint.MISSIONS, options);
+        return this.query(RLLEndPoint.MISSIONS, params);
     }
     /**
      * Fetch launch pads
@@ -160,10 +177,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 = queryOptionsValidator(RLLEndPoint.PADS, options);
+        return this.query(RLLEndPoint.PADS, params);
     }
     /**
      * Fetch launch tags
@@ -180,10 +198,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 = queryOptionsValidator(RLLEndPoint.TAGS, options);
+        return this.query(RLLEndPoint.TAGS, params);
     }
     /**
      * Fetch launch Vehicles
@@ -200,9 +219,10 @@ 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 = queryOptionsValidator(RLLEndPoint.VEHICLES, options);
+        return this.query(RLLEndPoint.VEHICLES, params);
     }
 }

package/lib/esm/Watcher.js

@@ -0,0 +1,169 @@
+import EventEmitter from "events";
+import { RLLEndPoint, } from "./types/application";
+import { error, warn, queryOptionsValidator, formatToRLLISODate, } from "./utils";
+const DEFAULT_INTERVAL_IN_MINS = 5;
+const MS_IN_MIN = 60000;
+const intervalValidator = (interval) => {
+    if (typeof interval !== "number" && typeof interval !== "string") {
+        error("RLLWatcher interval must be a number.");
+        return DEFAULT_INTERVAL_IN_MINS;
+    }
+    if (typeof interval === "string" &&
+        (isNaN(Number(interval)) || interval === "")) {
+        error("RLLWatcher interval must be a number.", "type");
+        return DEFAULT_INTERVAL_IN_MINS;
+    }
+    const typedInterval = Number(interval);
+    if (typedInterval <= 0) {
+        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) {
+        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
+ */
+export class RLLWatcher extends EventEmitter {
+    _untypedOn = this.on;
+    _untypedEmit = this.emit;
+    on = (event, listener) => this._untypedOn(event, listener);
+    emit = (event, ...args) => this._untypedEmit(event, ...args);
+    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();
+        this.last_call = new Date();
+        this.fetcher = fetcher;
+        this.interval = intervalValidator(interval);
+        this.params = queryOptionsValidator(RLLEndPoint.LAUNCHES, options);
+    }
+    /**
+     * 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", 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);
+        }
+    }
+}

package/lib/esm/fetcher.js

@@ -18,22 +18,29 @@ const query = (url, headers) => {
             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,7 @@
 import { RLLClient } from "./Client";
 export { RLLEndPoint, RLLEntity, } from "./types/application";
 export { RLLClient } from "./Client";
+export { RLLWatcher } from "./Watcher";
 /**
  * Generate a RocketLaunch.Live client
  *

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;IAkBtD;;;;;;;;;;;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,92 @@
+/// <reference types="node" />
+import EventEmitter from "events";
+import { RLLEntity, RLLError, RLLQueryConfig, RLLResponse } from "./types/application";
+interface IRLLWatcherEvent {
+    new: (launch: RLLEntity.Launch) => void;
+    change: (oldLaunch: RLLEntity.Launch, newLaunch: RLLEntity.Launch) => void;
+    error: (error: RLLError) => void;
+    ready: (launches: Map<number, RLLEntity.Launch>) => void;
+    init_error: (error: RLLError) => void;
+    call: (params: URLSearchParams) => void;
+}
+/**
+ * Class representing a RocketLaunch.Live Client Watcher
+ * @class
+ */
+export declare class RLLWatcher extends EventEmitter {
+    private _untypedOn;
+    private _untypedEmit;
+    on: <K extends keyof IRLLWatcherEvent>(event: K, listener: IRLLWatcherEvent[K]) => this;
+    emit: <K extends keyof IRLLWatcherEvent>(event: K, ...args: Parameters<IRLLWatcherEvent[K]>) => boolean;
+    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;
+}
+export {};
+//# 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,EACT,QAAQ,EACR,cAAc,EACd,WAAW,EACZ,MAAM,qBAAqB,CAAC;AA4C7B,UAAU,gBAAgB;IACxB,GAAG,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,KAAK,IAAI,CAAC;IACxC,MAAM,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,MAAM,KAAK,IAAI,CAAC;IAC3E,KAAK,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACjC,KAAK,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACzD,UAAU,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACtC,IAAI,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;CACzC;AAED;;;GAGG;AACH,qBAAa,UAAW,SAAQ,YAAY;IAC1C,OAAO,CAAC,UAAU,CAAW;IAC7B,OAAO,CAAC,YAAY,CAAa;IAC1B,EAAE,iFAGN,IAAI,CAAqC;IACrC,IAAI,4FAGR,OAAO,CAAsC;IAChD,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,CAA2B;IACxC,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;IAUnC;;;;;;;;;;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/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"}

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

@@ -14,13 +14,14 @@ export declare namespace RLLEntity {
     }
     export interface Country {
         name: string;
-        code: ISO3166Alpha2.CountryCode;
+        code: ISO3166Alpha2.CountryCode | "";
     }
     export interface State {
         name: string;
-        abbr: ISO3166Alpha2.StateCodeUS;
+        abbr?: ISO3166Alpha2.StateCodeUS;
     }
     export interface Company extends RLLRecord {
+        name: string;
         country: Country;
         inactive: boolean | null;
     }
@@ -40,12 +41,23 @@ export declare namespace RLLEntity {
     }
     export interface Launch extends RLLRecord {
         name: string;
-        cospar_id: string;
+        cospar_id: string | null;
         sort_date: string;
-        provider: Omit<Company, "inactive" | "country">;
-        vehicle: Omit<Vehicle, "company_id" | "company">;
-        pad: Omit<Pad, "full_name">;
-        missions: Omit<Mission, "launch_id">[];
+        provider: {
+            slug: string;
+        } & Omit<Company, "inactive" | "country">;
+        vehicle: {
+            company_id: number;
+            slug: string;
+        } & Omit<Vehicle, "company">;
+        pad: Omit<Pad, "full_name" | "location"> & {
+            location: Omit<Location, "pads" | "utc_offset" | "latitute" | "latitude" | "longitude" | "country" | "state"> & {
+                slug: string;
+                country: string;
+                state: ISO3166Alpha2.StateCodeUS | null;
+            };
+        };
+        missions: Omit<Mission, "launch_id" | "company">[];
         mission_description: string | null;
         launch_description: string;
         win_open: string | null;
@@ -61,6 +73,8 @@ export declare namespace RLLEntity {
         tags: Omit<Tag, "slug">[];
         slug: string;
         weather_summary: string | null;
+        weather_condition: string | null;
+        weather_wind_mph: number | null;
         weather_temp: number | null;
         weather_icon: string | null;
         weather_updated: string | null;
@@ -77,20 +91,20 @@ export declare namespace RLLEntity {
         longitude: string;
         state: State | null;
         statename?: string | null;
-        country: Country;
-        pads: Omit<Pad, "location" | "country" | "state">[];
-        utc_offset: number;
+        country: Country | null;
+        pads: Omit<Pad, "full_name" | "location" | "country" | "state">[];
+        utc_offset: number | null;
     }
     export interface Mission extends RLLRecord {
         name: string;
         description: string | null;
         launch_id: number;
-        company: Omit<Company, "slug" | "inactive" | "country">;
+        company: Omit<Company, "inactive" | "country">;
     }
     export interface Pad extends RLLRecord {
         name: string;
         full_name: string;
-        location: Omit<Location, "pads" | "utc_offset" | "latitute">;
+        location: Omit<Location, "pads" | "utc_offset" | "latitute" | "statename">;
     }
     export interface Tag extends RLLRecord {
         text: string;
@@ -98,8 +112,7 @@ export declare namespace RLLEntity {
     }
     export interface Vehicle extends RLLRecord {
         name: string;
-        company_id?: number;
-        company: Omit<Company, "slug" | "inactive" | "country">;
+        company: Omit<Company, "inactive" | "country">;
     }
     export {};
 }
@@ -181,4 +194,10 @@ export type RLLResponse<T> = {
     last_page: number;
     result: T;
 };
+export type RLLError = {
+    error: string;
+    statusCode: number | null;
+    message: string;
+    server_response: string | null;
+};
 //# sourceMappingURL=application.d.ts.map