@ecency/ns-query v1.2.11-next

Nostr protocol react-query based client SDK for Ecency

Overview

This repository contains react-query based SDK for Ececny vision and mobile projects

Installation

yarn add @ecency/ns-query

npm install @ecency/ns-query

Setup

1. Add ChatContextProvider to your App.tsx as root element
2. Pass there current user information via props

<ChatContextProvider activeUsername={} activeUserData={} />

3. Use!

Queries

High-level queries

1. Channels query – use this query for fetching user joined and created channels
   • Requirements – current user and its credentials
2. Community channel query – use this query for fetching the community channel from its posting json metadata
   • Requirements – nothing
3. Direct contacts query – use this query for fetching direct contacts of active user
   • Requirements – current user and its credentials
4. Left community channels query – use this query for fetching community channels from where active user had been left
   • Requirements – current user and its credentials
5. Messages query – use this query for fetching channel or contact messages based on their username
   • Requirements – current user and its credentials
   • Note – this query are invalidating each N seconds periodically to keep messages fresh
6. Joined community team query – use this query for fetching community team member which joined to chats and assigned to moderation team * Requirements – current user and its credentials
7. Created channels query – use this query for fetching created channels by current Nostr account
   • Requirements – current user and its credentials
8. Joined channels query – use this query for fetching all channels where current Nostr account was joined
   • Requirements – current user and its credentials
9. Last message query – fetch last message for specific contact or channel
   • Requirements – current user and its credentials

Low-level queries

Low-level queries builds the high-level queries above 1. Direct messages query – fetches direct messages by given direct contacts 2. Public messages query – fetches public messages by given channels

• Both of them builds messages query and shouldn't be used for messages management.

3. Get user profile query – fetching user metadata from Nostr by given public key

Mutations

High-level mutations

All mutations marked as override channel metadata means that mutation could by run only by channel owner 1. Add community channel – adds community channel to community list(only locally w/o saving in Nostr or Ecency) 2. Add direct contact – adding direct contact to contacts list 3. Create community chat – creates community channel and make current user as owner 4. Fetch previous messages – fetches channel's previous messages and appends to messages query 5. Hide messages in channel – hides message in a channel by owner(it overrides community channel metadata) 6. Import chats by keys – imports existing chat account and saves encrypted chat keys to accounts posting metadata 7. Join chat – creates chatting account and saves encrypted chat keys to account metadata 8. Leave community channel – leaves community channel 9. Logout from chats – clears current active user chatting session 10. Resend message – resends failed messages which already exists in queries with status 2 11. Restore chat by PIN – restores logged out account session by PIN 12. Send message – sends message to specific direct contact or channel 13. Update channel's blocked users – updates channel's blocked users(overrides channel metadata) 14. Update channel's moderator – add, remove or update channel's moderator 15. Update community channel – updates community channel's information(overrides channel metadata)

Low-level mutations

1. Find healthy relay – finds healthy Nostr relay and return its host(uses by library itself – no need to re-use it)
2. Send direct message – sends message to direct contact(uses in Send message)
3. Send public message – sends message to channel(uses in Send message)
4. Update left channels – updates left channels list(uses in add community channel and Leave community channel)

Misc

useActiveUserSwitching – invalidates all Nostr queries each time when active user changes(no need to call, library use it itself).

useAutoScrollInChatBox – uses for auto-scrolling to the end of chatbox(available in Web only)