fetcii

Simple Fetch module primarily designed for the aciiFX backend

Hier ist die Doku ebenfalls in deutsch.

Developer

• Flowtastisch

Credits

fetcii

• javascript
• typescript

fetcii (dev)

• concurrently
• express

Features

• simple fetch module 🎲
• inspired by odata v2 👀
• support of the four main CRUD methodes 📓
• integrated error handling -> always a message 💬
• supports automated filter, top, skip, select query parameter ✨
• designed for aciiFX, but also usable differently 🥑

Develop with fetcii

What you need

• NodeJS
• TypeScript npm install -g typescript

Installation

1. Install the fetcii package (e.g. yarn or npm)

   yarn add @aciiverse/fetcii
   
   npm i @aciiverse/fetcii

2. Now you can simply import fetcii eg.:

   import { fetcii } from "@aciiverse/fetcii";

   With this you see all functions and modules within fetcii. You can also import modules directly, for example: import { users } from "@aciiverse/fetcii";

Develop

Here are a few examples of how to use the functions:

getcii

Get all games

    import { fetcii } from "@aciiverse/fetcii";

    const url = 'http://localhost:3000/api/games'; // api url

    const result = await fetcii.getcii(url); // fetching (async await)

    if (result.err) {
        // -> error occured while fetching (frontend or backend)
        console.error(result.err?.message); // log error
    } else {
        // -> Success
        const games: Game[] = result.data?.data; // set data & assign own type (for typescript)

        // do what ever you want...

        console.log(result.data?.message); // log success message
    }

if only game 6-20 is to be output, you can use top & skip:

    const result = await fetcii.getcii(url, {
        top:    15, // get 15 games max
        skip:   5   // skip the first 5 games
    });

• the query parameters come as $top and $skip

if all games should be sorted (descending) release:

    const orderBy: OrderByType = {
        property: 'release',
        ascending: false
    };

    const result = await fetcii.getcii(url, {
        orderBy: orderBy
    });

• the query parameter comes as $orderBy

if all games should be sorted (ascending) title -> (ascending) id:

    const orderBy: OrderByType = [
        { property: 'title', ascending: true },
        { property: 'id', ascending: true }
    ];

    const result = await fetcii.getcii(url, {
        orderBy: orderBy
    });

• the query parameter comes as $orderBy

if only the title and the id should be selected, you can use select :

    const result = await fetcii.getcii(url, {
        select: ['title', 'id'] // select only the 'title' and 'id'
    });

• the query parameter comes as $select

if you want to filter, the new filter type can be used with the property filter:

• all games with the id 1:

  const filters = new FilterCollection();
  
  filters.add("id", [
      { operator: CompareOperator.Equal, value: 1 },
  ]);

• all games called 'Minecraft' or 'Portal 2':

  const filters = new FilterCollection();
  
  filters.add(
      "title",
      [
          { operator: CompareOperator.Equal, value: "Minecraft" },
          { operator: CompareOperator.Equal, value: "Portal 2" },
      ],
      false
  );

• all games called 'Minecraft' or (logic in aciiFX) released between 2020 and 2028

  const filters = new FilterCollection();
  
  filters.add("title", [
          { operator: CompareOperator.Equal, value: "Minecraft" },
  ]);
  filters.add(
      "release",
      [
          { operator: CompareOperator.GreaterEqual, value: 2020 },
          { operator: CompareOperator.LessEqual, value: 2028 },
      ],
      false
  );

• assign filters:

  const result = await fetcii.getcii(url, {
      filters: filters.getAllFilters(), // set filters
  });

• the query parameter comes as $filters

Get a single game

    import { fetcii } from "@aciiverse/fetcii";

    const url = 'http://localhost:3000/api/games/:id'; // api url

    const result = await fetcii.getcii(url); // fetching (async await)

    if (result.err) {
        // -> error occured while fetching (frontend or backend)
        console.error(result.err?.message); // log error
    } else {
        // -> success
        const game: Game = result.data?.data; // set data & assign own type (for typescript)

        // do what ever you want...

        console.log(result.data?.message); // log success message
    }

createcii

Create a game

    import { fetcii } from "@aciiverse/fetcii";

    const   url = 'http://localhost:3000/api/games', // api url
            data: Omit<Game, 'id'> = { // 'Omit' bewirkt, dass der type 'Game' ohne das property 'id' benutzt wird (typescript)
                title: 'Minecraft',
                language: 'Java',
                release: 2011
            };

    const result = await fetcii.createcii(url, data); // fetching (async await)

    if (result.err) {
        // -> error occured while fetching (frontend or backend)
        console.error(result.err?.message); // log error
    } else {
        // -> success
        const game: Game = result.data?.data; // set data & assign own type (for typescript)

        // do what ever you want...

        console.log(result.data?.message); // log success message
    }

updatecii

Edit a game

    import { fetcii } from "@aciiverse/fetcii";

    const   url = 'http://localhost:3000/api/games/:id', // api url
            data: Game = {
                title: 'Portal 2',
                language: 'C++',
                release: 2011
            };

    const result = await fetcii.updatecii(url, data); // fetching (async await)

    if (result.err) {
        // -> error occured while fetching (frontend or backend)
        console.error(result.err?.message); // log error
    } else {
        // -> success
        const game: Game = result.data?.data; // set data & assign own type (for typescript)

        // do what ever you want...

        console.log(result.data?.message); // log success message
    }

deletecii

Delete a game

    import { fetcii } from "@aciiverse/fetcii";

    const   url = 'http://localhost:3000/api/games/:id'; // api url

    const result = await removecii(url); // fetching (async await)

    if (result.err) {
        // -> error occured while fetching (frontend or backend)
        console.error(result.err?.message); // log error
    } else {
        // -> success

        // do what ever you want...

        console.log(result.data?.message); // log success message
    }

User module (best use with aciiFX) (user)

users.saveData()

• After a login you can save the token, token drop date and the user data:

  const url = 'http://localhost:3000/api/users/login';
  
  const result = await fetcii.createcii(url, {
      username: 'ezio',
      password: 'mySecretPassword'
  });
  
  // validation
  if (result.err) {
      // -> error occured
      console.error(result.err?.message); // log error
      return;
  }
  const data = result.data;
  
  // save data
  users.saveData({
      accessToken: data.token,
      userData: data.user,
      tokenExp: data.tokenExp
  });

users.getData()

• Receive user data

  export interface UserData {
      uuid: string;
      username: string;
      email: string;
      registered: Date;
      lastLogin?: Date;
      verified: boolean;
      isAdmin: boolean;
  }
  
  const data: UserData = users.getData();
  
  if (!data) return; // no data found

users.getToken()

• Receive the Access Token

  const token = users.getToken();
  
  if (!token) return; // no token found

• With the token you can execute getcii(), createcii(), updatecii() or deletecii():

• aciiFX has built-in middlewares that automatically consume the token

  const token = users.getToken();
  
  if (!token) return; // no token found
  
  const url = 'http://localhost:3000/api/games',
      result = await fetcii.getcii(url, {}, token); // fetching (async await);

users.deleteData()

• Delete the data you have saved

  users.deleteData();

• When you start the app, you want to use whether the token has expired, you can use the following

• It comes back whether the token has expired

• If you don't define any parameter, it automatically deletes the data

  users.checkTokenExpired();

  or

  const expired = users.checkTokenExpired();

  or

  const expired = users.checkTokenExpired(true);

  or

  users.checkTokenExpired(true);

• If the data should not be deleted:

  const expired = users.checkTokenExpired(false);