Alwatr Storage Client - @alwatr/storage-client

Elegant micro client for storage server written in tiny TypeScript ES module.

Example usage

1import {type AlwatrDocumentObject, AlwatrStorageClient} from '@alwatr/storage-client';
2
3type User = AlwatrDocumentObject & {
4  email: string;
5  token?: string;
6};
7
8const db = new AlwatrStorageClient<User>({
9  name: 'user-list',
10  host: '127.0.0.1',
11  port: 9000,
12  token: 'YOUR_SECRET_TOKEN',
13  timeout: 2_000,
14});
15
16await db.set({
17  id: 'alimd',
18  email: 'ali@mihandoost.com',
19});
20
21await db.set({
22  id: 'fmd',
23  email: 'Fatemeh@mihandoost.com',
24  token: Math.random().toString(36).substring(2, 15),
25});
26
27console.log("has 'alimd': %o", await db.has('alimd'));
28console.log('keys: %o', await db.keys());
29console.log('getAll: %o', await db.getAll());
30console.log('delete: %o', await db.delete('alimd'));
31try {
32  await db.delete('abcd');
33} catch (err) {
34  console.log('delete 404: %o', (err as Error).message);
35}

API

config.name: string

Storage name (like database name).

config.host: string

Storage server host name (URL).

config.token: string

Storage server token (like database password).

config.timeout?: number

A timeout in ms for the fetch request.

config.debug?: boolean

Debug output logs.

get(documentId: string): Promise<DocumentType>

Get a document object by id.

• documentId: The id of the document object.

Example:

1try {
2  const user = await userStorage.get('user-1');
3  console.dir(item);
4} catch (err) {
5  if ((err as Error)?.message === 'document_not_found') {
6    console.log('user_5000 id not found!');
7  } else {
8    console.error(err);
9  }
10}

has(documentId: string): Promise<boolean>

Check document exists by id.

• documentId: The id of the document object.

Example:

1const userExist = await userStorage.has('user-1');
2if (!userExist) console.log('user_not_found');

set(documentObject: DocumentType, fastInstance?: boolean): DocumentType

Insert/update a document object in the storage.

• documentObject: The document object to insert/update contain id.

Example:

1userStorage.set({
2  id: 'user-1',
3  foo: 'bar',
4});

delete(documentId: string): Promise<void>

Delete a document object from the storage.

Example:

1userStorage.delete('user-1');

getStorage(): Promise<AlwatrDocumentStorage>

Dump all storage data.

Example:

1const userStorage = await userStorage.getStorage();