{"id":13394253,"url":"https://github.com/americanexpress/iguazu","last_synced_at":"2025-03-13T20:31:24.591Z","repository":{"id":35088635,"uuid":"144909536","full_name":"americanexpress/iguazu","owner":"americanexpress","description":"✨ Iguazu is a simple Redux-powered Async Query engine","archived":true,"fork":false,"pushed_at":"2023-08-23T20:26:26.000Z","size":1797,"stargazers_count":201,"open_issues_count":0,"forks_count":15,"subscribers_count":23,"default_branch":"main","last_synced_at":"2024-04-14T13:05:31.146Z","etag":null,"topics":["async","asynchronous","iguazu","one-app","react","react-redux","redux"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/americanexpress.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2018-08-15T22:28:28.000Z","updated_at":"2024-04-14T13:05:31.147Z","dependencies_parsed_at":"2024-01-13T17:11:22.385Z","dependency_job_id":"d78a98de-4c00-4c84-bb29-747de7773de7","html_url":"https://github.com/americanexpress/iguazu","commit_stats":null,"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/americanexpress%2Figuazu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/americanexpress%2Figuazu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/americanexpress%2Figuazu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/americanexpress%2Figuazu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/americanexpress","download_url":"https://codeload.github.com/americanexpress/iguazu/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243478075,"owners_count":20297188,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["async","asynchronous","iguazu","one-app","react","react-redux","redux"],"created_at":"2024-07-30T17:01:13.908Z","updated_at":"2025-03-13T20:31:24.228Z","avatar_url":"https://github.com/americanexpress.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"\u003e ## **NOTICE:** Iguazu is no longer maintained. If you're looking for a data fetching solution for your React application, consider [Fetchye](https://github.com/americanexpress/fetchye). It is more performant and has a more intuitive API. If you know fetch, you know Fetchye.\n\n\u003ch1\u003e\n  \u003ccenter\u003e\n    \u003cbr /\u003e\n    \u003cimg src=\"./iguazu.png\" alt=\"iguazu - Iguazu\" width=\"50%\" /\u003e\n    \u003cbr /\u003e\u003cbr /\u003e\n  \u003c/center\u003e\n\u003c/h1\u003e\n\n[![npm version](https://badge.fury.io/js/iguazu.svg)](https://badge.fury.io/js/iguazu)\n![Main Health Check](https://github.com/americanexpress/iguazu/workflows/Main%20Health%20Check/badge.svg)\n\n\u003e Iguazu is a simple Redux-powered Async Query engine. By using a\n\u003e Higher-Order Component, Iguazu transparently manages dispatching async\n\u003e requests and injecting into React props. Iguazu has an ecosystem of\n\u003e adapters for various querying + caching strategies: [Iguazu RPC](https://github.com/americanexpress/iguazu-rpc), [Iguazu GraphQL](https://github.com/americanexpress/iguazu-graphql) and [Iguazu REST](https://github.com/americanexpress/iguazu-rest).\n\n## 👩‍💻 Hiring 👨‍💻\n\nWant to get paid for your contributions to `iguazu`?\n\u003e Send your resume to oneamex.careers@aexp.com\n\n## 📖 Table of Contents\n\n* [Features](#-features)\n* [Usage](#-usage)\n* [Upgrading](#-upgrading)\n* [Contributing](#-contributing)\n\n## ✨ Features\n\n* Streamlines dispatching, load states, and injecting into React props\n* Parallel and sequential async requests\n* Server-side rendering ready\n\n### Motivation\n\n[react-redux](https://github.com/reduxjs/react-redux) works great for when you want to take data that already exists in state and inject it as props into a React component, but it doesn't help you at all with the flow of loading asynchronous data into state. If a react component relies on asynchronous data you typically have to do three things:\n\n1. Define a load action responsible for fetching the asynchronous data, which should be triggered on mount and when the component receives new props that change what data should be loaded\n2. Define a `mapStateToProps` function and use selectors to get the data out of state\n3. Determine whether the state is actually loaded based on the props the selectors return\n\nIguazu seeks to simplify this flow into one step.\n\n## 🤹‍ Usage\n\n### Installation\n\n```bash\nnpm install --save iguazu\n```\n\n### Base Concepts\n\nIguazu exports a Higher Order Component (HOC) `connectAsync` similar to React Redux's `connect`.  Instead of taking a `mapStateToProps` function, it takes a `loadDataAsProps` function. It should return a map where each key is the name of a prop that will contain some asynchronous data and the value is the load function that will load that data if it is not already loaded.  The load function must synchronously return an object with the keys `data`, `status`, `error`, and `promise`. The key `data` should be the data returned from the asynchronous call. The key `status` should be either `loading` to signal the asynchronous call is in flight or `complete` to signal it has returned. The key `error` should be a truthy value if there was an error while loading. The key `promise` should be the promise of the asynchronous call.\n\nFor each key defined in the `loadDataAsProps` function, the HOC will pass a prop to the wrapped component that contains the data. It will also pass two function props, `isLoading` and `loadedWithErrors`, which will tell you if any of the async props are still loading or loaded with errors respectively. If you are only interested in a subset of async props, you can pass an array of the props names as the first argument. There will also be a prop named `loadErrors` that maps the load error, if there is one, for each prop. You can use this if you want to more granularly dig into what failed.\n\nExample:\n\n```javascript\n/* actions.js */\nimport React from 'react';\nimport { connectAsync } from 'iguazu';\n\nexport function queryMyData(param) {\n  return (dispatch, getState) =\u003e {\n    const data = getState().path.to.myData[param];\n    const status = data ? 'complete' : 'loading';\n    const promise = data ? Promise.resolve : dispatch(fetchMyData(param));\n\n    return { data, status, promise };\n  };\n}\n\nexport function queryMyOtherData(param) { /* Essentially the same as queryMyData */ }\n\n/* MyContainer.jsx */\nfunction MyContainer({\n  isLoading,\n  loadedWithErrors,\n  myData,\n  myOtherData,\n}) {\n  if (isLoading()) {\n    return \u003cdiv\u003eLoading...\u003c/div\u003e;\n  }\n\n  if (loadedWithErrors()) {\n    return \u003cdiv\u003eOh no! Something went wrong\u003c/div\u003e;\n  }\n\n  return (\n    \u003cdiv\u003e\n      myData =\n      {' '}\n      {myData}\n      myOtherData =\n      {' '}\n      {myOtherData}\n    \u003c/div\u003e\n  );\n}\n\nfunction loadDataAsProps({ store, ownProps }) {\n  const { dispatch, getState } = store;\n  return {\n    myData: () =\u003e dispatch(queryMyData(ownProps.someParam)),\n    myOtherData: () =\u003e dispatch(queryMyOtherData(getState().someOtherParam)),\n  };\n}\n\nexport default connectAsync({ loadDataAsProps })(MyContainer);\n```\n\nYou can see that by moving the logic responsible for selecting out the cached data and triggering a fetch if needed into the actions makes the components much simpler.\n\n### Advanced Concepts\n\n#### SSR\nThe main benefits of server side rendering are improved perceived speed and SEO. With perceived speed, the general best practice is to get something in front of the user's eyes as fast as possible. Typically that means you shouldn't wait for any data before rendering to string. For SEO, it's more important that you render the full content, and if that content is dynamic, you'll need to wait on some data. Usually not every view is important for SEO, such as logged in views, so the best option is to only preload data you absolutely have to for SEO. For this reason, Iguazu makes SSR data preloading opt in. If you would like a component's data to be loaded prior to rendering on the server, you can add a property named `ssr` with the value of true.\n\nExample:\n\n```javascript\n/* server.js */\nimport express from 'express';\n\nconst app = express();\n/* Component.jsx */\nfunction loadDataAsProps() { /* ... */ }\nloadDataAsProps.ssr = true;\n```\n\n#### Helper methods\nSometimes you might want to enable SSR preloading for a component, but only for some of its data. Iguazu provides some helper methods, `defer` and `noncritical`, to more granularly load data on the server. If you wrap a load function with `defer`, it will not execute the load function at all and will just return a status of `loading`. If you wrap a function with `noncritical`, the load function will execute, but its promise will be caught so that if it rejects it won't cause the Promise.all to reject and return before the other more critical pieces of data have returned.\n\nExample:\n\n```javascript\nimport { defer, noncritical } from 'iguazu';\n\nfunction loadDataAsProps() {\n  return {\n    clientOnlyData: defer(() =\u003e dispatch(loadClientData())),\n    tryToLoadOnServerData: noncritical(() =\u003e dispatch(loadIffyData())),\n  };\n}\n```\n\nIguazu will also pass a parameter to the load function that tells it whether it is running on the server or not. You might want to use this if you expect data to have a specific shape when it is not loaded, because `defer` will just return data as undefined.\n\nExample:\n\n```javascript\nfunction MyComponent({ someData }) {\n  return \u003cul\u003e{someData.list.map((item) =\u003e \u003cli key={item.toString()}\u003e{item}\u003c/li\u003e)}\u003c/ul\u003e;\n}\n\nfunction loadDataAsProps() {\n  return {\n    someData: ({ isServer }) =\u003e (isServer ? { data: { list: [] }, status: 'loading' } : dispatch(loadSomeData())),\n  };\n}\n```\n\n#### Synchronization\nLet's say you have a dynamic dashboard of components that are all responsible for loading their own data, but you want to wait until they are all loaded to render them so that you don't see a bunch of spinners or a partially loaded page. Since Iguazu attaches the loadDataAsProps function as a static, parent components can easily wait until their children's data is loaded before rendering them.\n\n```javascript\nimport React from 'react';\nimport { iguazuReduce } from 'iguazu';\nimport ComponentA from './ComponentA';\nimport ComponentB from './ComponentB';\n\nfunction MyComponent({ isLoading }) {\n  if (isLoading()) {\n    return (\u003cdiv\u003eLoading...\u003c/div\u003e);\n  }\n\n  return (\n    \u003cdiv\u003e\n      \u003cComponentA someParam=\"someParam\" /\u003e\n      \u003cComponentB /\u003e\n    \u003c/div\u003e\n  );\n}\n\nfunction loadDataAsProps({ store, ownProps }) {\n  return {\n    ComponentA: () =\u003e iguazuReduce(ComponentA.loadDataAsProps)({\n      store, ownProps: { someParam: 'someParam' },\n    }),\n    ComponentB: () =\u003e iguazuReduce(ComponentB.loadDataAsProps)({ store, ownProps: {} }),\n  };\n}\n```\n\n#### Sequencing\n\nQuite often you need the results of one asynchronous call to get the inputs for another call. One way to do this is by simply using components.\n\nExample:\n\n```javascript\nimport React from 'react';\nimport { connectAsync } from 'iguazu';\n\nfunction Parent({ isLoading, parent }) {\n  if (isLoading()) {\n    return \u003cdiv\u003eLoading Your Profile...\u003c/div\u003e;\n  }\n\n  return (\n    \u003cdiv\u003e\n      \u003cdiv\u003e\n        You:\n        \u003cPersonInfo info={parent} /\u003e\n      \u003c/div\u003e\n      \u003cKidsContainer parentId={parent.id} /\u003e\n    \u003c/div\u003e\n  );\n}\n\nfunction parentLoadDataAsProps({ store: { dispatch } }) {\n  return {\n    parents: () =\u003e dispatch(loadLoggedInParent()),\n  };\n}\n\nconst ParentContainer = connectAsync({ loadDataAsProps: parentLoadDataAsProps })(Parent);\n\nfunction Kids({ isLoading, kids }) {\n  if (isLoading()) {\n    return \u003cdiv\u003eLoading Kids...\u003c/div\u003e;\n  }\n\n  return (\n    \u003cdiv\u003e\n      Kids:\n      {kids.map((kid) =\u003e (\u003cPersonInfo key={kid.name} info={kid} /\u003e))}\n    \u003c/div\u003e\n  );\n}\n\nfunction kidsLoadDataAsProps({ store: { dispatch }, ownProps: { parentId } }) {\n  return {\n    kids: () =\u003e dispatch(loadKidsByParent(parentId)),\n  };\n}\n\nconst KidsContainer = connectAsync({ loadDataAsProps: kidsLoadDataAsProps })(Kids);\n\nfunction PersonInfo({ info: { name, age } }) {\n  return (\n    \u003cdiv\u003e\n      \u003cspan\u003e\n        name:\n        {' '}\n        {name}\n      \u003c/span\u003e\n      \u003cspan\u003e\n        age:\n        {' '}\n        {age}\n      \u003c/span\u003e\n    \u003c/div\u003e\n  );\n}\n```\n\nSuppose you want to synchronize the parent and kid components so that you show a loading spinner until they are both done loading their data. Or maybe you only have one component that needs some sequenced data and it doesn't make sense to create a new component for each nested piece of data. In these cases you can use the load helper, `sequence`. You can pass it an array of load functions that need to run in order and depend on data returned from previous functions.\n\nExample:\n\n```javascript\nimport React from 'react';\nimport { connectAsync, sequence } from 'iguazu';\n\nfunction Parent({ isLoading, parent, kids }) {\n  if (isLoading()) {\n    return \u003cdiv\u003eLoading Your Profile...\u003c/div\u003e;\n  }\n\n  return (\n    \u003cdiv\u003e\n      \u003cdiv\u003e\n        You:\n        \u003cPersonInfo info={parent} /\u003e\n      \u003c/div\u003e\n      \u003cKids kids={kids} /\u003e\n    \u003c/div\u003e\n  );\n}\n\nfunction parentLoadDataAsProps({ store: { dispatch } }) {\n  const sequenceLoadFunctions = sequence([\n    { key: 'parent', handler: () =\u003e dispatch(loadLoggedInParent()) },\n    { key: 'kids', handler: ({ parent }) =\u003e dispatch(loadKidsByParent(parent.id)) },\n  ]);\n\n  return {\n    ...sequenceLoadFunctions,\n  };\n}\n\nconst ParentContainer = connectAsync({ loadDataAsProps: parentLoadDataAsProps })(Parent);\n\nfunction Kids({ kids }) {\n  return (\n    \u003cdiv\u003e\n      Kids:\n      {kids.map((kid) =\u003e (\u003cPersonInfo key={kid.name} info={kid} /\u003e))}\n    \u003c/div\u003e\n  );\n}\n\nfunction PersonInfo({ info: { name, age } }) {\n  return (\n    \u003cdiv\u003e\n      \u003cspan\u003e\n        name:\n        {name}\n      \u003c/span\u003e\n      \u003cspan\u003e\n        age:\n        {age}\n      \u003c/span\u003e\n    \u003c/div\u003e\n  );\n}\n\n```\n\nSequenced function handlers are called with the results from all previous functions in case your inputs need to be derived from more than one previous call.\n\n```javascript\nconst sequenceLoadFunctions = sequence([\n  { key: 'first', handler: () =\u003e dispatch(loadFirst()) },\n  { key: 'second', handler: ({ first }) =\u003e dispatch(loadSecond(first.someParam)) },\n  { key: 'third', handler: ({ first, second }) =\u003e dispatch(loadThird(first.someParam, second.anotherParam)) },\n]);\n```\n\nIf you need to make two calls in parallel before you make a third, you can use a combination of `iguazuReduce` and `sequence` to accomplish your goal.\n\n```javascript\nconst sequenceLoadFunctions = sequence([\n  {\n    key: 'first',\n    handler: iguazuReduce(() =\u003e ({\n      firstA: () =\u003e dispatch(loadFirstA()),\n      firstB: () =\u003e dispatch(loadFirstB()),\n    })),\n  },\n  {\n    key: 'second', handler: ({ first: { firstA, firstB } }) =\u003e dispatch(loadSecond(firstA, firstB)),\n  },\n]);\n```\n\nFunction handlers require the previous calls to succeed to continue to the next by default. In the\nevent a request returns with an error all remaining calls are flagged with the same error. To bypass\nthis default behavior, you can wrap the function handler in `noncritical` to continue without the\nprevious results.\n\n```javascript\nconst sequenceLoadFunctions = sequence([\n  { key: 'first', handler: () =\u003e dispatch(loadFirst()) },\n  { key: 'second', handler: noncritical(({ first }) =\u003e dispatch(loadSecond(first.someParam))) },\n  { key: 'unrelated', handler: () =\u003e dispatch(loadUnrelated()) },\n]);\n```\n\n#### Updating\n\nIguazu processes updates on Redux state changes by comparing the previous and next responses from `loadDataAsProps` using\n[shallowequal](https://www.npmjs.com/package/shallowequal) by default. You are able to declare a comparator function when\ncalling `connectAsync` to manage how the previous and next responses from `loadDataAsProps` are compared.\n\n```javascript\nimport { deepEqual } from 'fast-equals';\n\nfunction loadDataAsProps({ store, ownProps }) {\n  const { dispatch, getState } = store;\n  return {\n    myData: () =\u003e dispatch(queryToDeeplyNestedData(ownProps.someParam)),\n    myOtherData: () =\u003e dispatch(queryMyOtherData(getState().someOtherParam)),\n  };\n}\n\nexport default connectAsync({\n  loadDataAsProps,\n  stateChangeComparator: deepEqual,\n})(MyContainer);\n```\n\n#### Limiting\n\nAs some functions called within `loadDataAsProps` can be expensive when ran on every Redux state change, you are able to declare a limiter function when calling `connectAsync`. Calls to `loadDataAsProps` are not limited by default.\n\n```javascript\nfunction loadDataAsProps({ store, ownProps }) {\n  const { dispatch, getState } = store;\n  return {\n    myData: () =\u003e dispatch(expensiveQueryToData(ownProps.someParam)),\n    myOtherData: () =\u003e dispatch(queryMyOtherData(getState().someOtherParam)),\n  };\n}\n\nexport default connectAsync({\n  loadDataAsProps,\n  stateChangeLimiter: (onStateChange) =\u003e debounce(onStateChange, 100),\n})(MyContainer);\n```\n\n#### Updating and Refreshing Data\n\nIn the case that we need to update a remote resource and refresh stale data:\n\n```javascript\n/* MyUpdatingComponent.jsx */\nimport React, { Component, Fragment } from 'react';\nimport { compose } from 'redux';\nimport { connect } from 'react-redux';\nimport { connectAsync } from 'iguazu';\n\nimport { getMyDataAction, updateMyDataAction } from './iguazuActionCreators';\n\nclass MyUpdatingComponent extends Component {\n  constructor(props) {\n    super(props);\n    this.state = { message: '' };\n  }\n\n  handleClick = () =\u003e {\n    const { updateMyData, getMyData } = this.props;\n    // Send updateMyData request\n    const { promise: updateMyDataPromise } = updateMyData('someParam');\n    return updateMyDataPromise\n      .then(() =\u003e {\n        // Refresh getMyData to get new results\n        const { promise: myDataPromise } = getMyData();\n        return myDataPromise;\n      })\n      .then(() =\u003e {\n        this.setState({ message: 'Success!' });\n      });\n  };\n\n  render() {\n    const { isLoading, loadedWithErrors, myData } = this.props;\n    const { message } = this.state;\n\n    if (isLoading()) {\n      return \u003cdiv\u003eLoading...\u003c/div\u003e;\n    }\n\n    if (loadedWithErrors()) {\n      return \u003cdiv\u003eOh no! Something went wrong\u003c/div\u003e;\n    }\n\n    return (\n      \u003cFragment\u003e\n        {message}\n        \u003cbutton type=\"button\" onClick={this.handleClick}\u003eUpdate\u003c/button\u003e\n        \u003ch1\u003eMy Data\u003c/h1\u003e\n        {myData}\n      \u003c/Fragment\u003e\n    );\n  }\n}\n\n// Hook up action creator functions to props to call later\nfunction mapDispatchToProps(dispatch) {\n  return {\n    // Update some remote resource\n    updateMyData: (someParam) =\u003e dispatch(updateMyDataAction(someParam)),\n    // Fetch some remote resource\n    getMyData: () =\u003e dispatch(getMyDataAction()),\n  };\n}\n\n// Hook up data dispatches on component load\nfunction loadDataAsProps({ store }) {\n  const { dispatch } = store;\n  return {\n    // Fetch some remote resource and inject it into props as myData\n    myData: () =\u003e dispatch(getMyDataAction()),\n  };\n}\n\nexport default compose(\n  connect(undefined, mapDispatchToProps),\n  connectAsync({ loadDataAsProps })\n)(MyUpdatingComponent);\n```\n\n#### Global Configuration\n\nIguazu is also capable of consuming global configuration that will be applied to all instances of `connectAsync`. These options will be applied unless otherwise overridden by providing the equivalent setting in the `connectAsync` call.\n\n```javascript\nimport { shallowEqual, deepEqual } from 'fast-equals';\nimport { configureIguazu } from 'iguazu';\n\nconfigureIguazu({\n  stateChangeComparator: shallowEqual, // applied globally.\n  stateChangeLimiter: (onStateChange) =\u003e debounce(onStateChange, 100), // applied globally.\n});\n\n/* ... */\n\nfunction loadDataAsProps({ store, ownProps }) {\n  const { dispatch, getState } = store;\n  return {\n    myData: () =\u003e dispatch(queryToDeeplyNestedData(ownProps.someParam)),\n    myOtherData: () =\u003e dispatch(expensiveQueryToData(ownProps.someParam)),\n  };\n}\n\nexport default connectAsync({\n  loadDataAsProps,\n  stateChangeComparator: deepEqual, // override global setting.\n  stateChangeLimiter: (onStateChange) =\u003e debounce(onStateChange, 500), // override global setting.\n})(MyContainer);\n```\n\n#### Known Issues\n\n- Using `iguazuReduce` within a `sequence` returns the response to the next handler as an array if the data is not loaded. Pass in `promiseAsObject` to `iguazuReduce` to resolve until next major version.\n\n```javascript\nconst sequenceLoadFunctions = sequence([\n  {\n    key: 'first',\n    handler: () =\u003e iguazuReduce(ComponentA.loadDataAsProps, { promiseAsObject: true })({\n      store, ownProps: { someParam: 'someParam' },\n    }),\n  },\n  { key: 'second', handler: ({ first }) =\u003e dispatch(loadSecond(first.someParam)) },\n]);\n```\n\n## 🚀 Upgrading\n\n### v2.x.x to v3.x.x\n\n- Upgraded to React Redux 7.x.x, Redux 4.x.x, and Redux Thunk 2.x.x\n- Using new [React Context](https://reactjs.org/docs/context.html) Consumer for retrieving Redux store.\n- Added a `ReduxConsumer` wrapping component to `connectAsync` which, may break jest snapshots.\n- Removed `enableSSR`, `disableSSR`, and `isSSR` methods in favor of checking for `window` to determine Server versus Client in SSR mode\n- `loadDataAsProps` functions receive `isServer` as an argument rather than `ssr` now.\n- Moved `react`, `react-dom`, `react-redux`, `redux`, and `redux-thunk` to `peerDependencies`\n- Removed `lodash` and decreased gzip bundle size from `~9.6kb` to `~4.5kb` gzipped.\n- Iguazu adapters remain compatible, just upgrade dependency on `iguazu` to `^3.0.0`.\n\n## 🏆 Contributing\n\nWe welcome Your interest in the American Express Open Source Community on Github.\nAny Contributor to any Open Source Project managed by the American Express Open\nSource Community must accept and sign an Agreement indicating agreement to the\nterms below. Except for the rights granted in this Agreement to American Express\nand to recipients of software distributed by American Express, You reserve all\nright, title, and interest, if any, in and to Your Contributions. Please [fill\nout the Agreement](https://cla-assistant.io/americanexpress/iguazu).\n\nPlease feel free to open pull requests and see [CONTRIBUTING.md](./CONTRIBUTING.md) to learn how to get started contributing.\n\n## 🗝️ License\n\nAny contributions made under this project will be governed by the [Apache License\n2.0](./LICENSE.txt).\n\n## 🗣️ Code of Conduct\n\nThis project adheres to the [American Express Community Guidelines](./CODE_OF_CONDUCT.md).\nBy participating, you are expected to honor these guidelines.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famericanexpress%2Figuazu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famericanexpress%2Figuazu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famericanexpress%2Figuazu/lists"}