mirror of
https://github.com/tcgdex/javascript-sdk.git
synced 2025-04-22 10:42:10 +00:00
Bump deps
Signed-off-by: Avior <github@avior.me>
This commit is contained in:
parent
3d8ef329f7
commit
496c04fc4c
GPG Key ID:
BEEAF3722D0EBF64
132
README.md
132
README.md
@ -8,13 +8,13 @@
|
|||||||
<img src="https://img.shields.io/npm/v/@tcgdex/sdk?style=flat-square" alt="NOM Version">
|
<img src="https://img.shields.io/npm/v/@tcgdex/sdk?style=flat-square" alt="NOM Version">
|
||||||
</a>
|
</a>
|
||||||
<a href="http://npmjs.com/@tcgdex/sdk">
|
<a href="http://npmjs.com/@tcgdex/sdk">
|
||||||
<img src="https://img.shields.io/npm/dw/@tcgdex/sdk?style=flat-square" alt="NPM Downloads">
|
<img src="https://img.shields.io/npm/dm/@tcgdex/sdk?style=flat-square" alt="NPM Downloads">
|
||||||
</a>
|
</a>
|
||||||
<a href="https://app.codecov.io/gh/tcgdex/javascript-sdk/">
|
<a href="https://app.codecov.io/gh/tcgdex/javascript-sdk/">
|
||||||
<img src="https://img.shields.io/codecov/c/github/tcgdex/javascript-sdk?style=flat-square&token=FR4BI94N4Q" alt="npm version">
|
<img src="https://img.shields.io/codecov/c/github/tcgdex/javascript-sdk?style=flat-square&token=FR4BI94N4Q" alt="npm version">
|
||||||
</a>
|
</a>
|
||||||
<a href="https://github.com/tcgdex/javascript-sdk/blob/master/LICENSE.md">
|
<a href="https://github.com/tcgdex/javascript-sdk/stargazers">
|
||||||
<img src="https://img.shields.io/github/license/tcgdex/javascript-sdk?style=flat-square" alt="the TCGdex JAvascript SDK is released under the MIT license." />
|
<img src="https://img.shields.io/github/stars/tcgdex/javascript-sdk?style=flat-square" alt="Github stars">
|
||||||
</a>
|
</a>
|
||||||
<a href="https://github.com/tcgdex/javascript-sdk/actions/workflows/build.yml">
|
<a href="https://github.com/tcgdex/javascript-sdk/actions/workflows/build.yml">
|
||||||
<img src="https://img.shields.io/github/workflow/status/tcgdex/javascript-sdk/Build%20&%20Test?style=flat-square" alt="the TCGdex JAvascript SDK is released under the MIT license." />
|
<img src="https://img.shields.io/github/workflow/status/tcgdex/javascript-sdk/Build%20&%20Test?style=flat-square" alt="the TCGdex JAvascript SDK is released under the MIT license." />
|
||||||
@ -26,58 +26,108 @@
|
|||||||
|
|
||||||
# TCGdex JavaScript/TypeScript SDK
|
# TCGdex JavaScript/TypeScript SDK
|
||||||
|
|
||||||
Communicate with the Open Source TCGdex API in Javascript/Typescript using the SDK
|
The Javascript/Typescript SDK provides a convenient access with the Open Source TCGdex API.
|
||||||
|
|
||||||
Full API/SDK documentation in progress at https://www.tcgdex.net/docs
|
The SDK is available in ESM and CommonJS and should be automaticly chosen.
|
||||||
|
|
||||||
## Getting Started
|
## Documentation
|
||||||
|
|
||||||
Install the SDK using:
|
_The full API/SDK documentation in progress at [API Documentation - TCGdex](https://www.tcgdex.dev)_
|
||||||
```bash
|
|
||||||
yarn add @tcgdex/sdk
|
### Getting Started
|
||||||
# or
|
|
||||||
npm install @tcgdex/sdk
|
#### How To install
|
||||||
```
|
|
||||||
|
**In the browser**
|
||||||
|
|
||||||
|
To use the SDK in the browser, simply add the following script tag to your
|
||||||
|
HTML pages:
|
||||||
|
|
||||||
or in the web browser
|
|
||||||
```html
|
```html
|
||||||
<script src="https://cdn.jsdelivr.net/npm/@tcgdex/sdk@2/dist/tcgdex.browser.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/@tcgdex/sdk@2/dist/tcgdex.browser.js"></script>
|
||||||
```
|
```
|
||||||
|
|
||||||
## Usage
|
You cna also download the script from [JSDelivr](https://cdn.jsdelivr.net/npm/@tcgdex/sdk@2/dist/tcgdex.browser.js) by right clicking the link and selecting save link as.
|
||||||
|
|
||||||
_Note: a complete documentation is in progress_
|
**In Node.js**
|
||||||
|
|
||||||
|
Simply type the following into a terminal window:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm install @tcgdex/sdk
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Usage
|
||||||
|
|
||||||
|
_Note: a complete documentation is available at [TCGdex.dev](https://www.tcgdex.dev)_
|
||||||
|
|
||||||
|
**Example: Fetch a Card**
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Import the SDK in Typescript
|
||||||
|
import TCGdex from '@tcgdex/sdk';
|
||||||
|
|
||||||
|
// Instantiate the SDK
|
||||||
|
// note: you can use one of the following lanugages
|
||||||
|
const tcgdex = new TCGdex('en');
|
||||||
|
|
||||||
|
// Card will be Furret from the Darkness Ablaze Set
|
||||||
|
const card = await tcgdex.fetch('cards', 'swsh3-136');
|
||||||
|
|
||||||
|
// You can also get the same result using
|
||||||
|
const card = await tcgdex.fetch('sets', 'Darkness Ablaze', 136);
|
||||||
|
```
|
||||||
|
|
||||||
|
**Other Examples**
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
// only if using with NPM/Yarn
|
// fetch a Set's informations using the set's name or ID
|
||||||
import TCGdex from '@tcgdex/sdk'
|
await tcgdex.fetch('sets', 'Darkness Ablaze')
|
||||||
|
|
||||||
// initialize the SDK
|
// Fetch a serie using the serie's name or ID
|
||||||
const tcgdex = new TCGdex('en') // Lang code (Optionnal) (See interfaces.ts line 1 for supported languages)
|
await tcgdex.fetch('series', 'Sword & Shield')
|
||||||
|
|
||||||
// if you need to change the language
|
// Fetch cards possible pokemon cards HP
|
||||||
tcgdex.lang = 'fr'
|
await tcgdex.fetch('hp');
|
||||||
|
|
||||||
// get a Card using its global ID
|
// Fetch Cards with the specific number of HP
|
||||||
await tcgdex.fetch('cards', 'base1-1')
|
await tcgdex.fetch('hp', 110);
|
||||||
|
|
||||||
// fetch a Card using it's local id and set name/ID
|
// Fetch cards possible illustrators
|
||||||
await tcgdex.fetch('sets', 'Base Set', 1)
|
await tcgdex.fetch('illustrators');
|
||||||
|
|
||||||
// fetch a Set's informations using the set's name/ID
|
// Fetch Cards with the specific illustrator
|
||||||
await tcgdex.fetch('sets', 'Sword & Shield')
|
await tcgdex.fetch('illustrators', 'tetsuya koizumi');
|
||||||
|
|
||||||
// Fetch a serie using the serie's name/ID
|
|
||||||
await tcgdex.fetch('series', 'Black & White')
|
|
||||||
|
|
||||||
// Fetch cards using other endpoints
|
|
||||||
/**
|
|
||||||
* categories => the the different cards categories
|
|
||||||
* hp => fetch the different cards possible HPs
|
|
||||||
* illustrators => fetch all the cards illustrators
|
|
||||||
* rarities => fetch the cards rarities
|
|
||||||
* retreats => fetch the cards using the retreat count
|
|
||||||
* types => fetch the cards using the Pokémon type(s)
|
|
||||||
**/
|
|
||||||
await tcgdex.fetch('categories')
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
**Other Endpoints**
|
||||||
|
|
||||||
|
_They work like the two (`hp` and `illustrators`) abose_
|
||||||
|
|
||||||
|
- categories: the the different cards categories
|
||||||
|
- energy-types: Fetch different types of energies
|
||||||
|
- hp: fetch the different cards possible HPs
|
||||||
|
- illustrators: fetch all the cards illustrators
|
||||||
|
- rarities: fetch the cards rarities
|
||||||
|
- retreats: fetch the cards using the retreat count
|
||||||
|
- stages: fetch differents cards stages
|
||||||
|
- suffixes: fetch differents cards suffixes
|
||||||
|
- trainer-types: fetch trainer cards types
|
||||||
|
- dex-ids: fetch pokemon Global Pokédex IDS
|
||||||
|
- types: fetch the cards using the Pokémon type(s)
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
See [CONTRIBUTING.md](https://github.com/tcgdex/javascript-sdk/blob/master/CONTRIBUTING.md)
|
||||||
|
|
||||||
|
TL::DR
|
||||||
|
|
||||||
|
- Fork
|
||||||
|
|
||||||
|
- Commit your changes
|
||||||
|
|
||||||
|
- Pull Request on this Repository
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
This project is licensed under the IT License. A copy of the license is available at [LICENSE.md](https://github.com/tcgdex/javascript-sdk/blob/master/LICENSE.md)
|
||||||
|
|||||||
5949
package-lock.json
generated
5949
package-lock.json
generated
File diff suppressed because it is too large
Load Diff
@ -27,10 +27,10 @@
|
|||||||
"@babel/preset-typescript": "^7.14.5",
|
"@babel/preset-typescript": "^7.14.5",
|
||||||
"@dzeio/config": "^1.0.0",
|
"@dzeio/config": "^1.0.0",
|
||||||
"@types/node-fetch": "^2.5.10",
|
"@types/node-fetch": "^2.5.10",
|
||||||
"@typescript-eslint/eslint-plugin": "^4.28.0",
|
"@typescript-eslint/eslint-plugin": "^5.7.0",
|
||||||
"@typescript-eslint/parser": "^4.28.0",
|
"@typescript-eslint/parser": "^5.7.0",
|
||||||
"esbuild": "^0.12.15",
|
"esbuild": "^0.14.5",
|
||||||
"eslint": "^7.29.0",
|
"eslint": "^8.4.1",
|
||||||
"jest": "^27.0.5",
|
"jest": "^27.0.5",
|
||||||
"ts-node": "^10.0.0",
|
"ts-node": "^10.0.0",
|
||||||
"typescript": "^4.1.3"
|
"typescript": "^4.1.3"
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user