Common Client functions

This script demonstrates how to use the fleare client library to create a connection to a remote Fleare server instance, handle lifecycle events, and cleanly manage the connection lifecycle using an asynchronous pattern.

PING

Sends a PING command to the server and receives a PONG response. Optionally, arguments can be passed which are echoed back after PONG . This is commonly used to check if the server is responsive (like a health check or heartbeat).

-> Read More

Import

  import fleare from "fleare";

Simple use

      const res = await client.ping(["Test", 1, 2, 3]);
    console.log(res);

Full Example

  async function main() {
  const client = fleare.createClient("127.0.0.1", 9219);
  ...
  
  try {
    await client.connect();

    const res = await client.ping(["Test", 1, 2, 3]);
    console.log(res);

  } catch (err) {
    console.error(err);
  } finally {
    await client.close();
  }
}

Output

  PONG Test 1 2 3

STATUS

The STATUS is used to retrieve the current state of the server, including server status, uptime, and detailed shard information. It helps users monitor the operational state of the server and its sharding configuration.

-> Read More

Simple use

      const res = await client.status();
    console.log(res);

Output

  {
  "server_status": "running",
  "shard_info": {
    "0": {
      "ID": "0",
      "host_address": "localhost:9291",
      "key_length": 123,
      "name": "Shard 0",
      "total_size": "8 bytes"
    },
    "1": {
      "ID": "1",
      "host_address": "localhost:9291",
      "key_length": 454,
      "name": "Shard 1",
      "total_size": "8 bytes"
    },
    "shard_count": 2
  },
  "up_time": "2025-06-18T11:30:45.123456789Z"
}

EXISTS

The EXISTS command is used to verify the existence of one or more keys in the database. It returns the count of keys that exist from the list provided.

-> Read More

Simple use

      const res = await client.exists("key1");
    console.log(res);

Output

  1

multi key use

      const res = await client.exists("key1", "key2", "no-key");
    console.log(res);

Output

  2

SESSION

The SESSION command returns the current session information for the authenticated client. It is typically used for diagnostics, auditing, or session lifecycle inspection.

-> Read More

Simple use

      const res = await client.session()
    console.log(res);

Output

  {
  "created_at": "2025-05-01T17:33:15.497273Z",
  "last_accessed_at": "2025-05-01T17:33:15.497273Z",
  "session_id": "8-127.0.0.1:53531",
  "status": 1,
  "user": {
    "Password": "*******",
    "Role": "Admin",
    "Username": "admin"
  }
}

SET

The SET command is used to store a key-value pair in the database. If the key already exists, the value is overwritten. It is a common operation to persist data in memory Database.

-> Read More

Simple use

  const res = await client.set("greetings", "Hello, Welcome to our service! Regards, Team")

Json use

  const res = await client.set("user:123", {
    "id":123,
    "name":"Alice",
    "roles":[
        "admin",
        "editor"
    ]
})
console.log(res);

Output empty body

  ""

GET

The GET command retrieves the value associated with a given key from the in-memory database. If the value is a nested JSON object, an optional path can be provided to extract specific nested fields.

-> Read More

Simple use

  const res = await client.get("user:123");
console.log(res);

Output body

  {
    "id":123,
    "name":"Alice",
    "roles":[
        "admin",
        "editor"
    ]
}

Using path

  const res = await client.get("user:123", "roles")
console.log(res);

Output body

  [ "admin", "editor" ]

DELETE

The DELETE command is used to remove a key-value pair from the in-memory database. It ensures the specified key is validated, removes it from the appropriate memory shard.

-> Read More

Simple use

  const res = await client.del("user:123");
console.log(res);

Output empty body

  ""