@synonymdev/react-native-pubky 0.7.1 → 0.9.0

package/README.md

@@ -18,16 +18,20 @@ npm install @synonymdev/react-native-pubky
 - [x] [resolveHttps](#resolveHttps): Resolve HTTPS records.
 - [x] [signUp](#signUp): Sign-up to a homeserver and update Pkarr accordingly.
 - [x] [signIn](#signIn): Sign-in to a homeserver.
+- [x] [session](#session): Check the current session for a given Pubky in its homeserver.
 - [x] [signOut](#signOut): Sign-out from a homeserver.
 - [x] [put](#put): Upload a small payload to a given path.
 - [x] [get](#get): Download a small payload from a given path relative to a pubky author.
 - [x] [list](#list): Returns a list of Pubky URLs of the files in the path of the `url` provided.
+- [x] [delete](#delete): Delete a file at a path relative to a pubky author.
 - [x] [generateSecretKey](#generateSecretKey): Generate a secret key.
 - [x] [getPublicKeyFromSecretKey](#getPublicKeyFromSecretKey): Get the public key string and uri from a secret key.
-### Methods to be Implemented
-- [ ] getProfile: Retrieve the profile of a user.
-- [ ] editProfile: Submit changes to the specified profile.
+- [x] [create_recovery_file](#createRecoveryFile): Create a recovery file.
+- [x] [decrypt_recovery_file](#decryptRecoveryFile): Decrypt a recovery file.
 
+### Methods to be Implemented
+- [ ] setProfile: Set profile information for a pubky.
+- [ ] getProfile: Get profile information for a pubky.
 
 ## Usage
 ### <a name="auth"></a>Auth
@@ -158,6 +162,20 @@ if (listRes.isErr()) {
 console.log(listRes.value);
 ```
 
+### <a name="deleteFile"></a>deleteFile
+```js
+import { deleteFile } from '@synonymdev/react-native-pubky';
+
+const deleteFileRes = await deleteFile(
+  'pubky://z4e8s17cou9qmuwen8p1556jzhf1wktmzo6ijsfnri9c4hnrdfty/pub/' // URL
+);
+if (deleteFileRes.isErr()) {
+  console.log(deleteFileRes.error.message);
+  return;
+}
+console.log(deleteFileRes.value);
+```
+
 ### <a name="generateSecretKey"></a>generateSecretKey
 ```js
 import { generateSecretKey } from '@synonymdev/react-native-pubky';
@@ -211,6 +229,20 @@ if (signInRes.isErr()) {
 console.log(signInRes.value);
 ```
 
+### <a name="session"></a>sessionRes
+```js
+import { session } from '@synonymdev/react-native-pubky';
+
+const sessionRes = await session(
+  'z4e8s17cou9qmuwen8p1556jzhf1wktmzo6ijsfnri9c4hnrdfty' // Public Key
+);
+if (sessionRes.isErr()) {
+  console.log(sessionRes.error.message);
+  return;
+}
+console.log(sessionRes.value);
+```
+
 ### <a name="signOut"></a>signIn
 ```js
 import { signOut } from '@synonymdev/react-native-pubky';
@@ -225,6 +257,36 @@ if (signOutRes.isErr()) {
 console.log(signOutRes.value);
 ```
 
+### <a name="createRecoveryFile"></a>createRecoveryFile
+```js
+import { createRecoveryFile } from '@synonymdev/react-native-pubky';
+
+const createRecoveryFileRes = await createRecoveryFile(
+  'e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855', // Secret Key
+  'passphrase', // Passphrase
+);
+if (createRecoveryFileRes.isErr()) {
+  console.log(createRecoveryFileRes.error.message);
+  return;
+}
+console.log(createRecoveryFileRes.value);
+```
+
+### <a name="decryptRecoveryFile"></a>decryptRecoveryFile
+```js
+import { decryptRecoveryFile } from '@synonymdev/react-native-pubky';
+
+const decryptRecoveryFileRes = await decryptRecoveryFile(
+  'cHVia3kub3JnL3JlY292ZXJ5CkZRt1NHIjxyTo0whSSgTgNrH56MPpGrSxvAQSE0x5FeklVJpNJqcNP4zjdwW/OpdBOsEC1qZ5MI/mcEUKFKVAEZwikdclsLZg==', // Recovery File
+  'passphrase', // Passphrase
+);
+if (decryptRecoveryFileRes.isErr()) {
+  console.log(decryptRecoveryFileRes.error.message);
+  return;
+}
+console.log(decryptRecoveryFileRes.value);
+```
+
 ## Local Installation
 
 1. Clone & npm install:
@@ -245,6 +307,16 @@ After making changes to any of the Rust files, the bindings will need to be upda
 npm run update-bindings
 ```
 
+## Run React Native Example App
+1. Run Homeserver:
+```sh
+cd rust/pubky/pubky-homeserver && cargo run -- --config=./src/config.toml
+```
+2. Run the React Native Example App:
+```sh
+cd example && yarn install && cd ios && pod install && cd ../ && yarn ios
+```
+
 Finally, ensure that `PubkyModule.kt`, `Pubky.swift`, `Pubky.mm` & `src/index.tsx` are updated accordingly based on the changes made to the Rust files.
 
 ## License