restql 1.1.8 → 1.2.1

package/README.md

@@ -1,14 +1,14 @@
-# RestQL.js
+# RestQL
 
 RESTful API Resolver for Nested-Linked Resources | 🕸 🕷
 
 ---
 
 [![npm](https://img.shields.io/npm/v/restql.svg?style=for-the-badge)](https://www.npmjs.com/package/restql/)
-![JavaScript](https://img.shields.io/badge/-JavaScript-F0DB4F?style=for-the-badge&logo=typescript&logoColor=black)
+![TypeScript](https://img.shields.io/badge/-TypeScript-3178C6?style=for-the-badge&logo=typescript&logoColor=white)
 ![Prettier](https://img.shields.io/badge/-Prettier-FF69B4?style=for-the-badge&logo=prettier&logoColor=white)
 
-RestQL allows you to dynamically resolve the nested-linked resources of a RESTful API.  
+RestQL allows you to dynamically resolve nested-linked resources of a RESTful API.  
 By specifying a set of properties to describe the paths.
 
 ## Installation
@@ -22,17 +22,16 @@ npm install restql
 ### CDN
 
 ```html
-<script src="https://unpkg.com/restql/dist/umd/index.min.js"></script>
+<script src="https://unpkg.com/restql/dist/index.min.js"></script>
 ```
 
 ## Usage
 
-### `restql(resource, resolver[, options])`
+### `restql<T>(resource, resolver[, options])`
 
 #### Parameters
 
 - `resource` (`string`): The resource to fetch.
-  - Self-explanatory.
 
 ##### Example
 
@@ -40,10 +39,10 @@ npm install restql
 'https://pokeapi.co/api/v2/pokemon/1/'
 ```
 
-- `resolver` (`Object`): The resolver to apply.
+- `resolver` ([`Resolver`](https://github.com/relztic/restql/blob/main/src/types.ts#L1)): The resolver to apply.
   - At every level, each property describes a path to the nested resources within the current one.
-  - RestQL resolves the sames and call the subsequent resolver against them.
-  - Until the base case (`null`) is reached; from which it returns back the merged responses.
+  - RestQL parses the same and calls the next resolver against them.
+  - Until the base case (`null`) is reached, from which it returns the merged responses.
 
 ##### Quantifiers
 
@@ -71,8 +70,7 @@ Following is a table of the quantifiers you can use:
 }
 ```
 
-- `[options]` (`Object`): The options to bypass.
-  - [See `RequestInit`](https://developer.mozilla.org/en-US/docs/Web/API/RequestInit)
+- `[options]` ([`RequestInit`](https://developer.mozilla.org/en-US/docs/Web/API/RequestInit)): The options to bypass.
 
 ##### Example
 
@@ -82,7 +80,7 @@ Following is a table of the quantifiers you can use:
 
 #### Returns
 
-(`Promise<Object>`): A promise which resolves into an object.
+(`Promise<T>`): A promise which resolves into a generic.
 
 ## Try It
 
@@ -90,7 +88,7 @@ Following is a table of the quantifiers you can use:
 npm run playground
 ```
 
-[See Playground](https://github.com/relztic/restql/blob/main/playground/index.js)
+[See Playground](https://github.com/relztic/restql/blob/main/playground/index.ts)
 
 ## Roadmap
 

package/dist/index.cjs

@@ -0,0 +1,128 @@
+'use strict';
+
+var esToolkit = require('es-toolkit');
+
+const responses = {};
+async function fetchResource(resource, options) {
+  const key = `${resource}-${JSON.stringify(options)}`;
+  if (!(key in responses)) {
+    responses[key] = fetch(resource, options).then((response) => {
+      responses[key] = response;
+      return response;
+    });
+  }
+  return responses[key];
+}
+
+function isResource(resource) {
+  return Boolean(URL.parse(resource));
+}
+
+const PROP_DELIMITER = ".";
+const REGEX_PROP_IS_ARR_IS_OPT = /^([^[\]?]+)(\[])?(\?)?$/;
+const constants = Object.freeze({
+  PROP_DELIMITER,
+  REGEX_PROP_IS_ARR_IS_OPT
+});
+
+function objectGet(obj, props) {
+  const nextPropsArr = props.split(constants.PROP_DELIMITER);
+  const [, prop, isArr, isOpt] = constants.REGEX_PROP_IS_ARR_IS_OPT.exec(nextPropsArr.shift()) || [];
+  const nextProps = nextPropsArr.join(constants.PROP_DELIMITER);
+  if (!prop) {
+    return obj;
+  }
+  if (!(prop in obj)) {
+    if (isOpt) {
+      return isArr ? [] : null;
+    }
+    throw new Error(`RuntimeError: could not get property \`${prop}\``);
+  }
+  const nextObjs = obj[prop];
+  return isArr ? nextObjs.map(
+    (nextObj) => objectGet(nextObj, nextProps)
+  ) : objectGet(nextObjs, nextProps);
+}
+
+function objectSet(data, props) {
+  const nextPropsArr = props.split(constants.PROP_DELIMITER);
+  const [, prop, isArr] = constants.REGEX_PROP_IS_ARR_IS_OPT.exec(nextPropsArr.shift()) || [];
+  const nextProps = nextPropsArr.join(constants.PROP_DELIMITER);
+  if (!prop) {
+    return data;
+  }
+  return {
+    [prop]: isArr ? data.map((nextData) => objectSet(nextData, nextProps)) : objectSet(data, nextProps)
+  };
+}
+
+async function resolve(resource, resolver, options) {
+  if (!resource) {
+    return null;
+  }
+  if (!isResource(resource)) {
+    throw new Error(`InvalidArgumentError: invalid resource \`${resource}\``);
+  }
+  const response = (await fetchResource(resource, options)).clone();
+  if (!response.ok) {
+    throw new Error(`RuntimeError: could not fetch resource \`${resource}\``);
+  }
+  const obj = await response.json();
+  if (resolver === null) {
+    return obj;
+  }
+  const resourcesObj = Object.keys(resolver).map((props) => ({
+    [props]: objectGet(obj, props)
+  }));
+  const resourcesArr = Object.entries(
+    resourcesObj.reduce((result, val) => ({ ...result, ...val }), {})
+  );
+  const responses = await Promise.all(
+    resourcesArr.map(async ([props, resources]) => {
+      const nextResolver = resolver[props];
+      const data = Array.isArray(resources) ? await Promise.all(
+        resources.map(
+          async (nextResource) => resolve(nextResource, nextResolver, options)
+        )
+      ) : await resolve(resources, nextResolver, options);
+      return [props, data];
+    })
+  );
+  return responses.reduce(
+    (result, [props, data]) => esToolkit.merge(result, objectSet(data, props)),
+    obj
+  );
+}
+
+function isObject(obj) {
+  return obj !== null && typeof obj === "object" && !Array.isArray(obj);
+}
+
+function isResolver(resolver) {
+  if (resolver === null) {
+    return true;
+  }
+  const keys = Object.keys(resolver);
+  if (!keys.length) {
+    return false;
+  }
+  return keys.map(
+    (key) => !key.startsWith(constants.PROP_DELIMITER) && !key.endsWith(constants.PROP_DELIMITER) && isResolver(resolver[key])
+  ).reduce((result, val) => result && val, true);
+}
+
+async function restql(resource, resolver, options = {}) {
+  if (!isObject(resolver) || !isResolver(resolver)) {
+    throw new Error(
+      `InvalidArgumentError: invalid resolver \`${JSON.stringify(resolver)}\``
+    );
+  }
+  if (!isObject(options)) {
+    throw new Error(
+      `InvalidArgumentError: invalid options \`${JSON.stringify(options)}\``
+    );
+  }
+  return resolve(resource, resolver, options);
+}
+
+module.exports = restql;

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+interface Resolver {
+    [key: string]: Resolver | null;
+}
+
+declare function restql<T extends object = Record<string, unknown>>(resource: string, resolver: Resolver, options?: RequestInit): Promise<T>;
+
+export { restql as default };
+export type { Resolver };

package/dist/{umd/index.js → index.js}

@@ -50,22 +50,11 @@
         return isPlainObject(value) || Array.isArray(value);
     }
 
-    /**
-     * @constant {Object} responses The responses to cache.
-     */
     const responses = {};
-
-    /**
-     * Fetches a resource based on its options, if not cached.
-     *
-     * @param {string} resource The resource to fetch.
-     * @param {Object} options  The options to bypass.
-     * @returns {Promise<Object>} A promise which resolves into an object.
-     */
     async function fetchResource(resource, options) {
       const key = `${resource}-${JSON.stringify(options)}`;
       if (!(key in responses)) {
-        responses[key] = fetch(resource, options).then(response => {
+        responses[key] = fetch(resource, options).then((response) => {
           responses[key] = response;
           return response;
         });
@@ -73,42 +62,17 @@
       return responses[key];
     }
 
-    /**
-     * Determines whether or not a resource is valid.
-     *
-     * @param {string} resource The resource to test.
-     * @returns {boolean} Whether or not a resource is valid.
-     */
     function isResource(resource) {
       return Boolean(URL.parse(resource));
     }
 
-    /**
-     * @constant {string} PROP_DELIMITER The delimiter of a property.
-     */
-    const PROP_DELIMITER = '.';
-
-    /**
-     * @constant {RegExp} REGEX_PROP_IS_ARR_IS_OPT Determines whether or not a property is an array and/or is optional.
-     */
+    const PROP_DELIMITER = ".";
     const REGEX_PROP_IS_ARR_IS_OPT = /^([^[\]?]+)(\[])?(\?)?$/;
-
-    /**
-     * @constant {Object} constants The constants of the library.
-     */
     const constants = Object.freeze({
       PROP_DELIMITER,
       REGEX_PROP_IS_ARR_IS_OPT
     });
 
-    /**
-     * Gets the parsed properties from an object.
-     *
-     * @param {Object} obj   The object to use.
-     * @param {string} props The properties to apply.
-     * @returns {Array} An array.
-     * @throws {RuntimeError} If a property could not be got.
-     */
     function objectGet(obj, props) {
       const nextPropsArr = props.split(constants.PROP_DELIMITER);
       const [, prop, isArr, isOpt] = constants.REGEX_PROP_IS_ARR_IS_OPT.exec(nextPropsArr.shift()) || [];
@@ -123,16 +87,11 @@
         throw new Error(`RuntimeError: could not get property \`${prop}\``);
       }
       const nextObjs = obj[prop];
-      return isArr ? nextObjs.map(nextObj => objectGet(nextObj, nextProps)) : objectGet(nextObjs, nextProps);
+      return isArr ? nextObjs.map(
+        (nextObj) => objectGet(nextObj, nextProps)
+      ) : objectGet(nextObjs, nextProps);
     }
 
-    /**
-     * Sets the parsed properties to an object.
-     *
-     * @param {Array}  data  The data to use.
-     * @param {string} props The properties to apply.
-     * @returns {Object} An object.
-     */
     function objectSet(data, props) {
       const nextPropsArr = props.split(constants.PROP_DELIMITER);
       const [, prop, isArr] = constants.REGEX_PROP_IS_ARR_IS_OPT.exec(nextPropsArr.shift()) || [];
@@ -141,20 +100,10 @@
         return data;
       }
       return {
-        [prop]: isArr ? data.map(nextData => objectSet(nextData, nextProps)) : objectSet(data, nextProps)
+        [prop]: isArr ? data.map((nextData) => objectSet(nextData, nextProps)) : objectSet(data, nextProps)
       };
     }
 
-    /**
-     * Resolves the nested-linked resources of a RESTful API.
-     *
-     * @param {string} resource The resource to fetch.
-     * @param {Object} resolver The resolver to apply.
-     * @param {Object} options  The options to bypass.
-     * @returns {Promise<Object>} A promise which resolves into an object.
-     * @throws {InvalidArgumentError} If a resource is invalid.
-     * @throws {RuntimeError}         If a resource could not be fetched.
-     */
     async function resolve(resource, resolver, options) {
       if (!resource) {
         return null;
@@ -167,67 +116,59 @@
         throw new Error(`RuntimeError: could not fetch resource \`${resource}\``);
       }
       const obj = await response.json();
-      if (!resolver) {
+      if (resolver === null) {
         return obj;
       }
-      const resourcesObj = Object.keys(resolver).map(props => ({
+      const resourcesObj = Object.keys(resolver).map((props) => ({
         [props]: objectGet(obj, props)
       }));
-      const resourcesArr = Object.entries(resourcesObj.reduce((result, val) => ({
-        ...result,
-        ...val
-      }), {}));
-      const responses = await Promise.all(resourcesArr.map(async ([props, resources]) => {
-        const nextResolver = resolver[props];
-        const data = Array.isArray(resources) ? await Promise.all(resources.map(async nextResource => resolve(nextResource, nextResolver, options))) : await resolve(resources, nextResolver, options);
-        return [props, data];
-      }));
-      return responses.reduce((result, [props, data]) => merge(result, objectSet(data, props)), obj);
+      const resourcesArr = Object.entries(
+        resourcesObj.reduce((result, val) => ({ ...result, ...val }), {})
+      );
+      const responses = await Promise.all(
+        resourcesArr.map(async ([props, resources]) => {
+          const nextResolver = resolver[props];
+          const data = Array.isArray(resources) ? await Promise.all(
+            resources.map(
+              async (nextResource) => resolve(nextResource, nextResolver, options)
+            )
+          ) : await resolve(resources, nextResolver, options);
+          return [props, data];
+        })
+      );
+      return responses.reduce(
+        (result, [props, data]) => merge(result, objectSet(data, props)),
+        obj
+      );
     }
 
-    /**
-     * Determines whether or not an object is valid.
-     *
-     * @param {Object} obj The object to test.
-     * @returns {boolean} Whether or not an object is valid.
-     */
     function isObject(obj) {
-      return obj !== null && typeof obj === 'object' && !Array.isArray(obj);
+      return obj !== null && typeof obj === "object" && !Array.isArray(obj);
     }
 
-    /**
-     * Determines whether or not a resolver is valid.
-     *
-     * @param {Object} resolver The resolver to test.
-     * @returns {boolean} Whether or not a resolver is valid.
-     */
     function isResolver(resolver) {
-      if (!resolver) {
+      if (resolver === null) {
         return true;
       }
       const keys = Object.keys(resolver);
       if (!keys.length) {
         return false;
       }
-      return keys.map(key => !key.startsWith(constants.PROP_DELIMITER) && !key.endsWith(constants.PROP_DELIMITER) && isResolver(resolver[key])).reduce((result, val) => result && val, true);
+      return keys.map(
+        (key) => !key.startsWith(constants.PROP_DELIMITER) && !key.endsWith(constants.PROP_DELIMITER) && isResolver(resolver[key])
+      ).reduce((result, val) => result && val, true);
     }
 
-    /**
-     * Resolves the nested-linked resources of a RESTful API.
-     *
-     * @param {string} resource  The resource to fetch.
-     * @param {Object} resolver  The resolver to apply.
-     * @param {Object} [options] The options to bypass.
-     * @returns {Promise<Object>} A promise which resolves into an object.
-     * @throws {InvalidArgumentError} If a resolver is invalid.
-     * @throws {InvalidArgumentError} If an options are invalid.
-     */
     async function restql(resource, resolver, options = {}) {
       if (!isObject(resolver) || !isResolver(resolver)) {
-        throw new Error(`InvalidArgumentError: invalid resolver \`${JSON.stringify(resolver)}\``);
+        throw new Error(
+          `InvalidArgumentError: invalid resolver \`${JSON.stringify(resolver)}\``
+        );
       }
       if (!isObject(options)) {
-        throw new Error(`InvalidArgumentError: invalid options \`${JSON.stringify(options)}\``);
+        throw new Error(
+          `InvalidArgumentError: invalid options \`${JSON.stringify(options)}\``
+        );
       }
       return resolve(resource, resolver, options);
     }

package/dist/index.min.js

@@ -0,0 +1,2 @@
+(function(l,a){typeof exports=="object"&&typeof module<"u"?module.exports=a():typeof define=="function"&&define.amd?define(a):(l=typeof globalThis<"u"?globalThis:l||self,l.restql=a())})(this,(function(){"use strict";function l(e){if(!e||typeof e!="object")return!1;const n=Object.getPrototypeOf(e);return n===null||n===Object.prototype||Object.getPrototypeOf(n)===null?Object.prototype.toString.call(e)==="[object Object]":!1}function a(e){return e==="__proto__"}function y(e,n){const t=Object.keys(n);for(let r=0;r<t.length;r++){const o=t[r];if(a(o))continue;const i=n[o],c=e[o];d(i)&&d(c)?e[o]=y(c,i):Array.isArray(i)?e[o]=y([],i):l(i)?e[o]=y({},i):(c===void 0||i!==void 0)&&(e[o]=i)}return e}function d(e){return l(e)||Array.isArray(e)}const R={};async function j(e,n){const t=`${e}-${JSON.stringify(n)}`;return t in R||(R[t]=fetch(e,n).then(r=>(R[t]=r,r))),R[t]}function h(e){return!!URL.parse(e)}const b=/^([^[\]?]+)(\[])?(\?)?$/,f=Object.freeze({PROP_DELIMITER:".",REGEX_PROP_IS_ARR_IS_OPT:b});function O(e,n){const t=n.split(f.PROP_DELIMITER),[,r,o,i]=f.REGEX_PROP_IS_ARR_IS_OPT.exec(t.shift())||[],c=t.join(f.PROP_DELIMITER);if(!r)return e;if(!(r in e)){if(i)return o?[]:null;throw new Error(`RuntimeError: could not get property \`${r}\``)}const s=e[r];return o?s.map(u=>O(u,c)):O(s,c)}function P(e,n){const t=n.split(f.PROP_DELIMITER),[,r,o]=f.REGEX_PROP_IS_ARR_IS_OPT.exec(t.shift())||[],i=t.join(f.PROP_DELIMITER);return r?{[r]:o?e.map(c=>P(c,i)):P(e,i)}:e}async function E(e,n,t){if(!e)return null;if(!h(e))throw new Error(`InvalidArgumentError: invalid resource \`${e}\``);const r=(await j(e,t)).clone();if(!r.ok)throw new Error(`RuntimeError: could not fetch resource \`${e}\``);const o=await r.json();if(n===null)return o;const i=Object.keys(n).map(s=>({[s]:O(o,s)})),c=Object.entries(i.reduce((s,u)=>({...s,...u}),{}));return(await Promise.all(c.map(async([s,u])=>{const p=n[s],w=Array.isArray(u)?await Promise.all(u.map(async A=>E(A,p,t))):await E(u,p,t);return[s,w]}))).reduce((s,[u,p])=>y(s,P(p,u)),o)}function _(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}function I(e){if(e===null)return!0;const n=Object.keys(e);return n.length?n.map(t=>!t.startsWith(f.PROP_DELIMITER)&&!t.endsWith(f.PROP_DELIMITER)&&I(e[t])).reduce((t,r)=>t&&r,!0):!1}async function m(e,n,t={}){if(!_(n)||!I(n))throw new Error(`InvalidArgumentError: invalid resolver \`${JSON.stringify(n)}\``);if(!_(t))throw new Error(`InvalidArgumentError: invalid options \`${JSON.stringify(t)}\``);return E(e,n,t)}return m}));
+//# sourceMappingURL=index.min.js.map

package/dist/index.min.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.min.js","sources":["../node_modules/es-toolkit/dist/predicate/isPlainObject.mjs","../node_modules/es-toolkit/dist/_internal/isUnsafeProperty.mjs","../node_modules/es-toolkit/dist/object/merge.mjs","../src/utils/fetchResource.ts","../src/utils/isResource.ts","../src/constants.ts","../src/utils/objectGet.ts","../src/utils/objectSet.ts","../src/resolve.ts","../src/utils/isObject.ts","../src/utils/isResolver.ts","../src/restql.ts"],"sourcesContent":["function isPlainObject(value) {\n    if (!value || typeof value !== 'object') {\n        return false;\n    }\n    const proto = Object.getPrototypeOf(value);\n    const hasObjectPrototype = proto === null ||\n        proto === Object.prototype ||\n        Object.getPrototypeOf(proto) === null;\n    if (!hasObjectPrototype) {\n        return false;\n    }\n    return Object.prototype.toString.call(value) === '[object Object]';\n}\n\nexport { isPlainObject };\n","function isUnsafeProperty(key) {\n    return key === '__proto__';\n}\n\nexport { isUnsafeProperty };\n","import { isUnsafeProperty } from '../_internal/isUnsafeProperty.mjs';\nimport { isPlainObject } from '../predicate/isPlainObject.mjs';\n\nfunction merge(target, source) {\n    const sourceKeys = Object.keys(source);\n    for (let i = 0; i < sourceKeys.length; i++) {\n        const key = sourceKeys[i];\n        if (isUnsafeProperty(key)) {\n            continue;\n        }\n        const sourceValue = source[key];\n        const targetValue = target[key];\n        if (isMergeableValue(sourceValue) && isMergeableValue(targetValue)) {\n            target[key] = merge(targetValue, sourceValue);\n        }\n        else if (Array.isArray(sourceValue)) {\n            target[key] = merge([], sourceValue);\n        }\n        else if (isPlainObject(sourceValue)) {\n            target[key] = merge({}, sourceValue);\n        }\n        else if (targetValue === undefined || sourceValue !== undefined) {\n            target[key] = sourceValue;\n        }\n    }\n    return target;\n}\nfunction isMergeableValue(value) {\n    return isPlainObject(value) || Array.isArray(value);\n}\n\nexport { merge };\n","const responses: Record<string, Promise<Response> | Response> = {}\n\nexport default async function fetchResource(\n  resource: string,\n  options: RequestInit,\n): Promise<Response> {\n  const key = `${resource}-${JSON.stringify(options)}`\n\n  if (!(key in responses)) {\n    responses[key] = fetch(resource, options).then((response) => {\n      responses[key] = response\n\n      return response\n    })\n  }\n\n  return responses[key]\n}\n","export default function isResource(resource: string): boolean {\n  return Boolean(URL.parse(resource))\n}\n","const PROP_DELIMITER: string = '.'\n\nconst REGEX_PROP_IS_ARR_IS_OPT: RegExp = /^([^[\\]?]+)(\\[])?(\\?)?$/\n\nconst constants = Object.freeze({\n  PROP_DELIMITER,\n  REGEX_PROP_IS_ARR_IS_OPT,\n})\n\nexport default constants\n","import constants from '../constants'\n\nexport default function objectGet(\n  obj: Record<string, unknown>,\n  props: string,\n): unknown {\n  const nextPropsArr = props.split(constants.PROP_DELIMITER)\n\n  const [, prop, isArr, isOpt] =\n    constants.REGEX_PROP_IS_ARR_IS_OPT.exec(nextPropsArr.shift()!) || []\n\n  const nextProps = nextPropsArr.join(constants.PROP_DELIMITER)\n\n  if (!prop) {\n    return obj\n  }\n\n  if (!(prop in obj)) {\n    if (isOpt) {\n      return isArr ? [] : null\n    }\n\n    throw new Error(`RuntimeError: could not get property \\`${prop}\\``)\n  }\n\n  const nextObjs = obj[prop]\n\n  return isArr\n    ? (nextObjs as unknown[]).map((nextObj) =>\n        objectGet(nextObj as Record<string, unknown>, nextProps),\n      )\n    : objectGet(nextObjs as Record<string, unknown>, nextProps)\n}\n","import constants from '../constants'\n\nexport default function objectSet(\n  data: unknown,\n  props: string,\n): Record<string, unknown> {\n  const nextPropsArr = props.split(constants.PROP_DELIMITER)\n\n  const [, prop, isArr] =\n    constants.REGEX_PROP_IS_ARR_IS_OPT.exec(nextPropsArr.shift()!) || []\n\n  const nextProps = nextPropsArr.join(constants.PROP_DELIMITER)\n\n  if (!prop) {\n    return data as Record<string, unknown>\n  }\n\n  return {\n    [prop]: isArr\n      ? (data as unknown[]).map((nextData) => objectSet(nextData, nextProps))\n      : objectSet(data, nextProps),\n  }\n}\n","import { merge } from 'es-toolkit'\n\nimport type { Resolver } from './types'\nimport fetchResource from './utils/fetchResource'\nimport isResource from './utils/isResource'\nimport objectGet from './utils/objectGet'\nimport objectSet from './utils/objectSet'\n\nexport default async function resolve(\n  resource: string,\n  resolver: Resolver | null,\n  options: RequestInit,\n): Promise<Record<string, unknown> | null> {\n  if (!resource) {\n    return null\n  }\n\n  if (!isResource(resource)) {\n    throw new Error(`InvalidArgumentError: invalid resource \\`${resource}\\``)\n  }\n\n  const response = (await fetchResource(resource, options)).clone()\n\n  if (!response.ok) {\n    throw new Error(`RuntimeError: could not fetch resource \\`${resource}\\``)\n  }\n\n  const obj = await response.json()\n\n  if (resolver === null) {\n    return obj\n  }\n\n  const resourcesObj = Object.keys(resolver).map((props) => ({\n    [props]: objectGet(obj, props),\n  }))\n\n  const resourcesArr = Object.entries(\n    resourcesObj.reduce((result, val) => ({ ...result, ...val }), {}),\n  )\n\n  const responses = await Promise.all(\n    resourcesArr.map(async ([props, resources]) => {\n      const nextResolver = resolver[props]\n\n      const data = Array.isArray(resources)\n        ? await Promise.all(\n            resources.map(async (nextResource: string) =>\n              resolve(nextResource, nextResolver, options),\n            ),\n          )\n        : await resolve(resources as string, nextResolver, options)\n\n      return [props, data]\n    }),\n  )\n\n  return responses.reduce(\n    (result, [props, data]) => merge(result, objectSet(data, props as string)),\n    obj,\n  )\n}\n","export default function isObject(obj: unknown): boolean {\n  return obj !== null && typeof obj === 'object' && !Array.isArray(obj)\n}\n","import constants from '../constants'\nimport type { Resolver } from '../types'\n\nexport default function isResolver(resolver: Resolver | null): boolean {\n  if (resolver === null) {\n    return true\n  }\n\n  const keys = Object.keys(resolver)\n\n  if (!keys.length) {\n    return false\n  }\n\n  return keys\n    .map(\n      (key) =>\n        !key.startsWith(constants.PROP_DELIMITER) &&\n        !key.endsWith(constants.PROP_DELIMITER) &&\n        isResolver(resolver[key]),\n    )\n    .reduce((result, val) => result && val, true)\n}\n","import resolve from './resolve'\nimport type { Resolver } from './types'\nimport isObject from './utils/isObject'\nimport isResolver from './utils/isResolver'\n\nexport default async function restql<\n  T extends object = Record<string, unknown>,\n>(resource: string, resolver: Resolver, options: RequestInit = {}): Promise<T> {\n  if (!isObject(resolver) || !isResolver(resolver)) {\n    throw new Error(\n      `InvalidArgumentError: invalid resolver \\`${JSON.stringify(resolver)}\\``,\n    )\n  }\n\n  if (!isObject(options)) {\n    throw new Error(\n      `InvalidArgumentError: invalid options \\`${JSON.stringify(options)}\\``,\n    )\n  }\n\n  return resolve(resource, resolver, options) as Promise<T>\n}\n"],"names":["isPlainObject","value","proto","isUnsafeProperty","key","merge","target","source","sourceKeys","i","sourceValue","targetValue","isMergeableValue","responses","fetchResource","resource","options","response","isResource","REGEX_PROP_IS_ARR_IS_OPT","constants","objectGet","obj","props","nextPropsArr","prop","isArr","isOpt","nextProps","nextObjs","nextObj","objectSet","data","nextData","resolve","resolver","resourcesObj","resourcesArr","result","val","resources","nextResolver","nextResource","isObject","isResolver","keys","restql"],"mappings":"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","x_google_ignoreList":[0,1,2]}

package/dist/index.mjs

@@ -0,0 +1,126 @@
+import { merge } from 'es-toolkit';
+
+const responses = {};
+async function fetchResource(resource, options) {
+  const key = `${resource}-${JSON.stringify(options)}`;
+  if (!(key in responses)) {
+    responses[key] = fetch(resource, options).then((response) => {
+      responses[key] = response;
+      return response;
+    });
+  }
+  return responses[key];
+}
+
+function isResource(resource) {
+  return Boolean(URL.parse(resource));
+}
+
+const PROP_DELIMITER = ".";
+const REGEX_PROP_IS_ARR_IS_OPT = /^([^[\]?]+)(\[])?(\?)?$/;
+const constants = Object.freeze({
+  PROP_DELIMITER,
+  REGEX_PROP_IS_ARR_IS_OPT
+});
+
+function objectGet(obj, props) {
+  const nextPropsArr = props.split(constants.PROP_DELIMITER);
+  const [, prop, isArr, isOpt] = constants.REGEX_PROP_IS_ARR_IS_OPT.exec(nextPropsArr.shift()) || [];
+  const nextProps = nextPropsArr.join(constants.PROP_DELIMITER);
+  if (!prop) {
+    return obj;
+  }
+  if (!(prop in obj)) {
+    if (isOpt) {
+      return isArr ? [] : null;
+    }
+    throw new Error(`RuntimeError: could not get property \`${prop}\``);
+  }
+  const nextObjs = obj[prop];
+  return isArr ? nextObjs.map(
+    (nextObj) => objectGet(nextObj, nextProps)
+  ) : objectGet(nextObjs, nextProps);
+}
+
+function objectSet(data, props) {
+  const nextPropsArr = props.split(constants.PROP_DELIMITER);
+  const [, prop, isArr] = constants.REGEX_PROP_IS_ARR_IS_OPT.exec(nextPropsArr.shift()) || [];
+  const nextProps = nextPropsArr.join(constants.PROP_DELIMITER);
+  if (!prop) {
+    return data;
+  }
+  return {
+    [prop]: isArr ? data.map((nextData) => objectSet(nextData, nextProps)) : objectSet(data, nextProps)
+  };
+}
+
+async function resolve(resource, resolver, options) {
+  if (!resource) {
+    return null;
+  }
+  if (!isResource(resource)) {
+    throw new Error(`InvalidArgumentError: invalid resource \`${resource}\``);
+  }
+  const response = (await fetchResource(resource, options)).clone();
+  if (!response.ok) {
+    throw new Error(`RuntimeError: could not fetch resource \`${resource}\``);
+  }
+  const obj = await response.json();
+  if (resolver === null) {
+    return obj;
+  }
+  const resourcesObj = Object.keys(resolver).map((props) => ({
+    [props]: objectGet(obj, props)
+  }));
+  const resourcesArr = Object.entries(
+    resourcesObj.reduce((result, val) => ({ ...result, ...val }), {})
+  );
+  const responses = await Promise.all(
+    resourcesArr.map(async ([props, resources]) => {
+      const nextResolver = resolver[props];
+      const data = Array.isArray(resources) ? await Promise.all(
+        resources.map(
+          async (nextResource) => resolve(nextResource, nextResolver, options)
+        )
+      ) : await resolve(resources, nextResolver, options);
+      return [props, data];
+    })
+  );
+  return responses.reduce(
+    (result, [props, data]) => merge(result, objectSet(data, props)),
+    obj
+  );
+}
+
+function isObject(obj) {
+  return obj !== null && typeof obj === "object" && !Array.isArray(obj);
+}
+
+function isResolver(resolver) {
+  if (resolver === null) {
+    return true;
+  }
+  const keys = Object.keys(resolver);
+  if (!keys.length) {
+    return false;
+  }
+  return keys.map(
+    (key) => !key.startsWith(constants.PROP_DELIMITER) && !key.endsWith(constants.PROP_DELIMITER) && isResolver(resolver[key])
+  ).reduce((result, val) => result && val, true);
+}
+
+async function restql(resource, resolver, options = {}) {
+  if (!isObject(resolver) || !isResolver(resolver)) {
+    throw new Error(
+      `InvalidArgumentError: invalid resolver \`${JSON.stringify(resolver)}\``
+    );
+  }
+  if (!isObject(options)) {
+    throw new Error(
+      `InvalidArgumentError: invalid options \`${JSON.stringify(options)}\``
+    );
+  }
+  return resolve(resource, resolver, options);
+}
+
+export { restql as default };

package/package.json

@@ -1,28 +1,38 @@
 {
   "name": "restql",
-  "version": "1.1.8",
+  "version": "1.2.1",
   "description": "RESTful API Resolver for Nested-Linked Resources | 🕸 🕷",
   "type": "module",
-  "main": "./dist/cjs/index.js",
-  "module": "./dist/esm/index.js",
-  "unpkg": "./dist/umd/index.js",
+  "unpkg": "./dist/index.js",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.cjs"
+    }
+  },
   "files": [
     "dist/"
   ],
   "scripts": {
-    "prepare": "npm run clear && npm run lint && npm run test && npm run build",
-    "clear": "rm -fr ./coverage/ ./dist/ ./stats.html",
+    "prepare": "npm run clean && npm run lint && npm run test && npm run build",
+    "clean": "rm -fr ./coverage/ ./dist/ ./stats.html",
     "lint": "eslint ./src/",
     "lint:fix": "npm run lint -- --fix",
-    "test": "jest --config ./.jest.config.json",
+    "test": "jest ./src/",
     "test:coverage": "npm run test -- --coverage",
     "test:watch": "npm run test -- --watch",
-    "playground": "BABEL_ENV=development babel-node --config-file ./.babelrc ./playground/index.js",
-    "build": "npm run build:cjs && npm run build:esm && npm run build:umd && npm run build:umd:min",
-    "build:cjs": "BABEL_ENV=production MODULE_FMT=cjs rollup --config",
-    "build:esm": "BABEL_ENV=production MODULE_FMT=esm rollup --config",
-    "build:umd": "BABEL_ENV=production MODULE_FMT=umd rollup --config",
-    "build:umd:min": "BABEL_ENV=production MODULE_FMT=umd MINIFY=true rollup --config"
+    "build": "npm run build:cjs && npm run build:esm && npm run build:umd && npm run build:umd:min && npm run build:types",
+    "build:cjs": "MODULE_FMT=cjs rollup --config",
+    "build:esm": "MODULE_FMT=esm rollup --config",
+    "build:umd": "MODULE_FMT=umd rollup --config",
+    "build:umd:min": "MODULE_FMT=umd MINIFY=true rollup --config",
+    "build:types": "MODULE_FMT=esm TYPES=true rollup --config",
+    "playground": "tsx ./playground/index.ts"
   },
   "repository": {
     "type": "git",
@@ -30,7 +40,7 @@
   },
   "keywords": [
     "package",
-    "javascript",
+    "typescript",
     "rest",
     "api",
     "recursive",
@@ -46,25 +56,26 @@
     "es-toolkit": "^1.44.0"
   },
   "devDependencies": {
-    "@babel/core": "^7.26.0",
-    "@babel/node": "^7.29.0",
-    "@babel/preset-env": "^7.26.0",
-    "@rollup/plugin-babel": "^6.1.0",
-    "@rollup/plugin-commonjs": "^29.0.0",
-    "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
-    "@rollup/plugin-terser": "^0.4.4",
     "@trivago/prettier-plugin-sort-imports": "^6.0.2",
-    "eslint": "^10.0.2",
+    "@types/jest": "^30.0.0",
+    "eslint": "^10.0.3",
     "eslint-config-prettier": "^10.1.8",
     "eslint-flat-config-airbnb": "^2.0.5",
+    "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-jest": "^29.15.0",
     "eslint-plugin-prettier": "^5.5.5",
     "globals": "^17.3.0",
     "jest": "^30.2.0",
     "prettier": "^3.8.1",
     "rollup": "^4.59.0",
-    "rollup-plugin-visualizer": "^7.0.0"
+    "rollup-plugin-dts": "^6.3.0",
+    "rollup-plugin-esbuild": "^6.2.1",
+    "rollup-plugin-visualizer": "^7.0.0",
+    "ts-jest": "^29.4.6",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.56.1"
   },
   "overrides": {
     "serialize-javascript": "^7.0.3"

package/dist/cjs/index.js

@@ -1,187 +0,0 @@
-'use strict';
-
-var esToolkit = require('es-toolkit');
-
-/**
- * @constant {Object} responses The responses to cache.
- */
-const responses = {};
-
-/**
- * Fetches a resource based on its options, if not cached.
- *
- * @param {string} resource The resource to fetch.
- * @param {Object} options  The options to bypass.
- * @returns {Promise<Object>} A promise which resolves into an object.
- */
-async function fetchResource(resource, options) {
-  const key = `${resource}-${JSON.stringify(options)}`;
-  if (!(key in responses)) {
-    responses[key] = fetch(resource, options).then(response => {
-      responses[key] = response;
-      return response;
-    });
-  }
-  return responses[key];
-}
-
-/**
- * Determines whether or not a resource is valid.
- *
- * @param {string} resource The resource to test.
- * @returns {boolean} Whether or not a resource is valid.
- */
-function isResource(resource) {
-  return Boolean(URL.parse(resource));
-}
-
-/**
- * @constant {string} PROP_DELIMITER The delimiter of a property.
- */
-const PROP_DELIMITER = '.';
-
-/**
- * @constant {RegExp} REGEX_PROP_IS_ARR_IS_OPT Determines whether or not a property is an array and/or is optional.
- */
-const REGEX_PROP_IS_ARR_IS_OPT = /^([^[\]?]+)(\[])?(\?)?$/;
-
-/**
- * @constant {Object} constants The constants of the library.
- */
-const constants = Object.freeze({
-  PROP_DELIMITER,
-  REGEX_PROP_IS_ARR_IS_OPT
-});
-
-/**
- * Gets the parsed properties from an object.
- *
- * @param {Object} obj   The object to use.
- * @param {string} props The properties to apply.
- * @returns {Array} An array.
- * @throws {RuntimeError} If a property could not be got.
- */
-function objectGet(obj, props) {
-  const nextPropsArr = props.split(constants.PROP_DELIMITER);
-  const [, prop, isArr, isOpt] = constants.REGEX_PROP_IS_ARR_IS_OPT.exec(nextPropsArr.shift()) || [];
-  const nextProps = nextPropsArr.join(constants.PROP_DELIMITER);
-  if (!prop) {
-    return obj;
-  }
-  if (!(prop in obj)) {
-    if (isOpt) {
-      return isArr ? [] : null;
-    }
-    throw new Error(`RuntimeError: could not get property \`${prop}\``);
-  }
-  const nextObjs = obj[prop];
-  return isArr ? nextObjs.map(nextObj => objectGet(nextObj, nextProps)) : objectGet(nextObjs, nextProps);
-}
-
-/**
- * Sets the parsed properties to an object.
- *
- * @param {Array}  data  The data to use.
- * @param {string} props The properties to apply.
- * @returns {Object} An object.
- */
-function objectSet(data, props) {
-  const nextPropsArr = props.split(constants.PROP_DELIMITER);
-  const [, prop, isArr] = constants.REGEX_PROP_IS_ARR_IS_OPT.exec(nextPropsArr.shift()) || [];
-  const nextProps = nextPropsArr.join(constants.PROP_DELIMITER);
-  if (!prop) {
-    return data;
-  }
-  return {
-    [prop]: isArr ? data.map(nextData => objectSet(nextData, nextProps)) : objectSet(data, nextProps)
-  };
-}
-
-/**
- * Resolves the nested-linked resources of a RESTful API.
- *
- * @param {string} resource The resource to fetch.
- * @param {Object} resolver The resolver to apply.
- * @param {Object} options  The options to bypass.
- * @returns {Promise<Object>} A promise which resolves into an object.
- * @throws {InvalidArgumentError} If a resource is invalid.
- * @throws {RuntimeError}         If a resource could not be fetched.
- */
-async function resolve(resource, resolver, options) {
-  if (!resource) {
-    return null;
-  }
-  if (!isResource(resource)) {
-    throw new Error(`InvalidArgumentError: invalid resource \`${resource}\``);
-  }
-  const response = (await fetchResource(resource, options)).clone();
-  if (!response.ok) {
-    throw new Error(`RuntimeError: could not fetch resource \`${resource}\``);
-  }
-  const obj = await response.json();
-  if (!resolver) {
-    return obj;
-  }
-  const resourcesObj = Object.keys(resolver).map(props => ({
-    [props]: objectGet(obj, props)
-  }));
-  const resourcesArr = Object.entries(resourcesObj.reduce((result, val) => ({
-    ...result,
-    ...val
-  }), {}));
-  const responses = await Promise.all(resourcesArr.map(async ([props, resources]) => {
-    const nextResolver = resolver[props];
-    const data = Array.isArray(resources) ? await Promise.all(resources.map(async nextResource => resolve(nextResource, nextResolver, options))) : await resolve(resources, nextResolver, options);
-    return [props, data];
-  }));
-  return responses.reduce((result, [props, data]) => esToolkit.merge(result, objectSet(data, props)), obj);
-}
-
-/**
- * Determines whether or not an object is valid.
- *
- * @param {Object} obj The object to test.
- * @returns {boolean} Whether or not an object is valid.
- */
-function isObject(obj) {
-  return obj !== null && typeof obj === 'object' && !Array.isArray(obj);
-}
-
-/**
- * Determines whether or not a resolver is valid.
- *
- * @param {Object} resolver The resolver to test.
- * @returns {boolean} Whether or not a resolver is valid.
- */
-function isResolver(resolver) {
-  if (!resolver) {
-    return true;
-  }
-  const keys = Object.keys(resolver);
-  if (!keys.length) {
-    return false;
-  }
-  return keys.map(key => !key.startsWith(constants.PROP_DELIMITER) && !key.endsWith(constants.PROP_DELIMITER) && isResolver(resolver[key])).reduce((result, val) => result && val, true);
-}
-
-/**
- * Resolves the nested-linked resources of a RESTful API.
- *
- * @param {string} resource  The resource to fetch.
- * @param {Object} resolver  The resolver to apply.
- * @param {Object} [options] The options to bypass.
- * @returns {Promise<Object>} A promise which resolves into an object.
- * @throws {InvalidArgumentError} If a resolver is invalid.
- * @throws {InvalidArgumentError} If an options are invalid.
- */
-async function restql(resource, resolver, options = {}) {
-  if (!isObject(resolver) || !isResolver(resolver)) {
-    throw new Error(`InvalidArgumentError: invalid resolver \`${JSON.stringify(resolver)}\``);
-  }
-  if (!isObject(options)) {
-    throw new Error(`InvalidArgumentError: invalid options \`${JSON.stringify(options)}\``);
-  }
-  return resolve(resource, resolver, options);
-}
-
-module.exports = restql;

package/dist/esm/index.js

@@ -1,185 +0,0 @@
-import { merge } from 'es-toolkit';
-
-/**
- * @constant {Object} responses The responses to cache.
- */
-const responses = {};
-
-/**
- * Fetches a resource based on its options, if not cached.
- *
- * @param {string} resource The resource to fetch.
- * @param {Object} options  The options to bypass.
- * @returns {Promise<Object>} A promise which resolves into an object.
- */
-async function fetchResource(resource, options) {
-  const key = `${resource}-${JSON.stringify(options)}`;
-  if (!(key in responses)) {
-    responses[key] = fetch(resource, options).then(response => {
-      responses[key] = response;
-      return response;
-    });
-  }
-  return responses[key];
-}
-
-/**
- * Determines whether or not a resource is valid.
- *
- * @param {string} resource The resource to test.
- * @returns {boolean} Whether or not a resource is valid.
- */
-function isResource(resource) {
-  return Boolean(URL.parse(resource));
-}
-
-/**
- * @constant {string} PROP_DELIMITER The delimiter of a property.
- */
-const PROP_DELIMITER = '.';
-
-/**
- * @constant {RegExp} REGEX_PROP_IS_ARR_IS_OPT Determines whether or not a property is an array and/or is optional.
- */
-const REGEX_PROP_IS_ARR_IS_OPT = /^([^[\]?]+)(\[])?(\?)?$/;
-
-/**
- * @constant {Object} constants The constants of the library.
- */
-const constants = Object.freeze({
-  PROP_DELIMITER,
-  REGEX_PROP_IS_ARR_IS_OPT
-});
-
-/**
- * Gets the parsed properties from an object.
- *
- * @param {Object} obj   The object to use.
- * @param {string} props The properties to apply.
- * @returns {Array} An array.
- * @throws {RuntimeError} If a property could not be got.
- */
-function objectGet(obj, props) {
-  const nextPropsArr = props.split(constants.PROP_DELIMITER);
-  const [, prop, isArr, isOpt] = constants.REGEX_PROP_IS_ARR_IS_OPT.exec(nextPropsArr.shift()) || [];
-  const nextProps = nextPropsArr.join(constants.PROP_DELIMITER);
-  if (!prop) {
-    return obj;
-  }
-  if (!(prop in obj)) {
-    if (isOpt) {
-      return isArr ? [] : null;
-    }
-    throw new Error(`RuntimeError: could not get property \`${prop}\``);
-  }
-  const nextObjs = obj[prop];
-  return isArr ? nextObjs.map(nextObj => objectGet(nextObj, nextProps)) : objectGet(nextObjs, nextProps);
-}
-
-/**
- * Sets the parsed properties to an object.
- *
- * @param {Array}  data  The data to use.
- * @param {string} props The properties to apply.
- * @returns {Object} An object.
- */
-function objectSet(data, props) {
-  const nextPropsArr = props.split(constants.PROP_DELIMITER);
-  const [, prop, isArr] = constants.REGEX_PROP_IS_ARR_IS_OPT.exec(nextPropsArr.shift()) || [];
-  const nextProps = nextPropsArr.join(constants.PROP_DELIMITER);
-  if (!prop) {
-    return data;
-  }
-  return {
-    [prop]: isArr ? data.map(nextData => objectSet(nextData, nextProps)) : objectSet(data, nextProps)
-  };
-}
-
-/**
- * Resolves the nested-linked resources of a RESTful API.
- *
- * @param {string} resource The resource to fetch.
- * @param {Object} resolver The resolver to apply.
- * @param {Object} options  The options to bypass.
- * @returns {Promise<Object>} A promise which resolves into an object.
- * @throws {InvalidArgumentError} If a resource is invalid.
- * @throws {RuntimeError}         If a resource could not be fetched.
- */
-async function resolve(resource, resolver, options) {
-  if (!resource) {
-    return null;
-  }
-  if (!isResource(resource)) {
-    throw new Error(`InvalidArgumentError: invalid resource \`${resource}\``);
-  }
-  const response = (await fetchResource(resource, options)).clone();
-  if (!response.ok) {
-    throw new Error(`RuntimeError: could not fetch resource \`${resource}\``);
-  }
-  const obj = await response.json();
-  if (!resolver) {
-    return obj;
-  }
-  const resourcesObj = Object.keys(resolver).map(props => ({
-    [props]: objectGet(obj, props)
-  }));
-  const resourcesArr = Object.entries(resourcesObj.reduce((result, val) => ({
-    ...result,
-    ...val
-  }), {}));
-  const responses = await Promise.all(resourcesArr.map(async ([props, resources]) => {
-    const nextResolver = resolver[props];
-    const data = Array.isArray(resources) ? await Promise.all(resources.map(async nextResource => resolve(nextResource, nextResolver, options))) : await resolve(resources, nextResolver, options);
-    return [props, data];
-  }));
-  return responses.reduce((result, [props, data]) => merge(result, objectSet(data, props)), obj);
-}
-
-/**
- * Determines whether or not an object is valid.
- *
- * @param {Object} obj The object to test.
- * @returns {boolean} Whether or not an object is valid.
- */
-function isObject(obj) {
-  return obj !== null && typeof obj === 'object' && !Array.isArray(obj);
-}
-
-/**
- * Determines whether or not a resolver is valid.
- *
- * @param {Object} resolver The resolver to test.
- * @returns {boolean} Whether or not a resolver is valid.
- */
-function isResolver(resolver) {
-  if (!resolver) {
-    return true;
-  }
-  const keys = Object.keys(resolver);
-  if (!keys.length) {
-    return false;
-  }
-  return keys.map(key => !key.startsWith(constants.PROP_DELIMITER) && !key.endsWith(constants.PROP_DELIMITER) && isResolver(resolver[key])).reduce((result, val) => result && val, true);
-}
-
-/**
- * Resolves the nested-linked resources of a RESTful API.
- *
- * @param {string} resource  The resource to fetch.
- * @param {Object} resolver  The resolver to apply.
- * @param {Object} [options] The options to bypass.
- * @returns {Promise<Object>} A promise which resolves into an object.
- * @throws {InvalidArgumentError} If a resolver is invalid.
- * @throws {InvalidArgumentError} If an options are invalid.
- */
-async function restql(resource, resolver, options = {}) {
-  if (!isObject(resolver) || !isResolver(resolver)) {
-    throw new Error(`InvalidArgumentError: invalid resolver \`${JSON.stringify(resolver)}\``);
-  }
-  if (!isObject(options)) {
-    throw new Error(`InvalidArgumentError: invalid options \`${JSON.stringify(options)}\``);
-  }
-  return resolve(resource, resolver, options);
-}
-
-export { restql as default };

package/dist/umd/index.min.js

@@ -1 +0,0 @@
-!function(t,r){"object"==typeof exports&&"undefined"!=typeof module?module.exports=r():"function"==typeof define&&define.amd?define(r):(t="undefined"!=typeof globalThis?globalThis:t||self).restql=r()}(this,function(){"use strict";function t(t){if(!t||"object"!=typeof t)return!1;const r=Object.getPrototypeOf(t);return!(null!==r&&r!==Object.prototype&&null!==Object.getPrototypeOf(r))&&"[object Object]"===Object.prototype.toString.call(t)}function r(t){return"__proto__"===t}function n(o,i){const c=Object.keys(i);for(let u=0;u<c.length;u++){const s=c[u];if(r(s))continue;const f=i[s],a=o[s];e(f)&&e(a)?o[s]=n(a,f):Array.isArray(f)?o[s]=n([],f):t(f)?o[s]=n({},f):void 0!==a&&void 0===f||(o[s]=f)}return o}function e(r){return t(r)||Array.isArray(r)}const o={};async function i(t,r){const n=`${t}-${JSON.stringify(r)}`;return n in o||(o[n]=fetch(t,r).then(t=>(o[n]=t,t))),o[n]}const c=Object.freeze({PROP_DELIMITER:".",REGEX_PROP_IS_ARR_IS_OPT:/^([^[\]?]+)(\[])?(\?)?$/});function u(t,r){const n=r.split(c.PROP_DELIMITER),[,e,o,i]=c.REGEX_PROP_IS_ARR_IS_OPT.exec(n.shift())||[],s=n.join(c.PROP_DELIMITER);if(!e)return t;if(!(e in t)){if(i)return o?[]:null;throw new Error(`RuntimeError: could not get property \`${e}\``)}const f=t[e];return o?f.map(t=>u(t,s)):u(f,s)}function s(t,r){const n=r.split(c.PROP_DELIMITER),[,e,o]=c.REGEX_PROP_IS_ARR_IS_OPT.exec(n.shift())||[],i=n.join(c.PROP_DELIMITER);return e?{[e]:o?t.map(t=>s(t,i)):s(t,i)}:t}async function f(t,r,e){if(!t)return null;if(!function(t){return Boolean(URL.parse(t))}(t))throw new Error(`InvalidArgumentError: invalid resource \`${t}\``);const o=(await i(t,e)).clone();if(!o.ok)throw new Error(`RuntimeError: could not fetch resource \`${t}\``);const c=await o.json();if(!r)return c;const a=Object.keys(r).map(t=>({[t]:u(c,t)})),l=Object.entries(a.reduce((t,r)=>({...t,...r}),{}));return(await Promise.all(l.map(async([t,n])=>{const o=r[t];return[t,Array.isArray(n)?await Promise.all(n.map(async t=>f(t,o,e))):await f(n,o,e)]}))).reduce((t,[r,e])=>n(t,s(e,r)),c)}function a(t){return null!==t&&"object"==typeof t&&!Array.isArray(t)}function l(t){if(!t)return!0;const r=Object.keys(t);return!!r.length&&r.map(r=>!r.startsWith(c.PROP_DELIMITER)&&!r.endsWith(c.PROP_DELIMITER)&&l(t[r])).reduce((t,r)=>t&&r,!0)}return async function(t,r,n={}){if(!a(r)||!l(r))throw new Error(`InvalidArgumentError: invalid resolver \`${JSON.stringify(r)}\``);if(!a(n))throw new Error(`InvalidArgumentError: invalid options \`${JSON.stringify(n)}\``);return f(t,r,n)}});