restql 1.1.7 → 1.2.0

package/README.md

@@ -5,10 +5,10 @@ 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,36 +22,29 @@ 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>
 ```
 
-## Parameters
-
-### `resource`
+## Usage
 
-`{string} The resource to fetch.`
+### `restql(resource, resolver[, options])`
 
-**Description**
+#### Parameters
 
-Self-explanatory.
+- `resource` (`string`): The resource to fetch.
 
-**e.g.:**
+##### Example
 
 ```js
 'https://pokeapi.co/api/v2/pokemon/1/'
 ```
 
-### `resolver`
-
-`{Object} The resolver to apply.`
-
-**Description**
+- `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 parses the same and calls the next resolver against them.
+  - Until the base case (`null`) is reached, from which it returns the merged responses.
 
-At each 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.
-
-**Quantifiers**
+##### Quantifiers
 
 Following is a table of the quantifiers you can use:
 
@@ -60,7 +53,7 @@ Following is a table of the quantifiers you can use:
 | `[]`       | Collection of properties. |
 | `?`        | Optional property.        |
 
-**e.g.:**
+##### Example
 
 ```js
 {
@@ -77,66 +70,26 @@ Following is a table of the quantifiers you can use:
 }
 ```
 
-### `[options]`
-
-`{Object} The options to bypass.`
-
-**Description**
-
-[`Request Config`](https://github.com/axios/axios/tree/v1.13.6#request-config)
+- `[options]` ([`RequestInit`](https://developer.mozilla.org/en-US/docs/Web/API/RequestInit)): The options to bypass.
 
-**e.g.:**
+##### Example
 
 ```js
-{
-  // ...
-}
+{ ... }
 ```
 
-## Usage
+#### Returns
 
-```js
-import restql from 'restql'
+(`Promise<T extends object = Record<string, unknown>>`): A promise which resolves into an object.
 
-/**
- * @constant {string} resource The resource to fetch.
- */
-const resource = 'https://pokeapi.co/api/v2/pokemon/1/'
+## Try It
 
-/**
- * @constant {Object} resolver The resolver to apply.
- */
-const resolver = {
-  'abilities[]?.ability.url': {
-    'generation.url': {
-      'main_region.url': null,
-    },
-  },
-  'stats[].stat.url?': {
-    'affecting_natures.increase[].url': null,
-    'affecting_natures.decrease[].url': null,
-  },
-  'moves[].move?.url': null,
-}
-
-/**
- * @constant {Object} options The options to bypass.
- */
-const options = {
-  // ...
-}
-
-;(async () => {
-  try {
-    const data = await restql(resource, resolver, options)
-
-    console.log(data)
-  } catch (error) {
-    console.error(error.message)
-  }
-})()
+```sh
+npm run playground
 ```
 
+[See Playground](https://github.com/relztic/restql/blob/main/playground/index.ts)
+
 ## Roadmap
 
 - ~~Support for authentication~~
@@ -145,4 +98,4 @@ const options = {
 - ~~Ability to cache responses~~
 - Support for recursive resolvers
 
-Take 🎂, Folks! 🌮 🐴 💨
+> Take 🎂, Folks! 🌮 🐴 💨

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/index.js

@@ -0,0 +1,178 @@
+(function (global, factory) {
+    typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
+    typeof define === 'function' && define.amd ? define(factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, global.restql = factory());
+})(this, (function () { 'use strict';
+
+    function isPlainObject(value) {
+        if (!value || typeof value !== 'object') {
+            return false;
+        }
+        const proto = Object.getPrototypeOf(value);
+        const hasObjectPrototype = proto === null ||
+            proto === Object.prototype ||
+            Object.getPrototypeOf(proto) === null;
+        if (!hasObjectPrototype) {
+            return false;
+        }
+        return Object.prototype.toString.call(value) === '[object Object]';
+    }
+
+    function isUnsafeProperty(key) {
+        return key === '__proto__';
+    }
+
+    function merge(target, source) {
+        const sourceKeys = Object.keys(source);
+        for (let i = 0; i < sourceKeys.length; i++) {
+            const key = sourceKeys[i];
+            if (isUnsafeProperty(key)) {
+                continue;
+            }
+            const sourceValue = source[key];
+            const targetValue = target[key];
+            if (isMergeableValue(sourceValue) && isMergeableValue(targetValue)) {
+                target[key] = merge(targetValue, sourceValue);
+            }
+            else if (Array.isArray(sourceValue)) {
+                target[key] = merge([], sourceValue);
+            }
+            else if (isPlainObject(sourceValue)) {
+                target[key] = merge({}, sourceValue);
+            }
+            else if (targetValue === undefined || sourceValue !== undefined) {
+                target[key] = sourceValue;
+            }
+        }
+        return target;
+    }
+    function isMergeableValue(value) {
+        return isPlainObject(value) || Array.isArray(value);
+    }
+
+    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);
+    }
+
+    return restql;
+
+}));

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 };