anzar 1.2.7 → 1.2.9

package/README.md

@@ -0,0 +1,95 @@
+# Anzar SDK Documentation
+
+## Install The Typescript SDK
+In a ts project run the following command to install the anzar package.
+
+**npm**
+```bash
+$ npm install anzar
+```
+
+**pnpm**
+```bash
+$ pnpm install anzar
+```
+
+**yarn**
+```bash
+$ yarn add anzar
+```
+
+## Create Anzar Auth Instance
+if you are using `vite` as a bundler, add this to your `vite.config.js`
+```javascript 
+import yaml from "@rollup/plugin-yaml";
+
+export default {
+  plugins: [yaml()],
+};
+```
+```bash 
+$ npm install -D @rollup/plugin-yaml
+```
+
+in your main entry file (`main.ts` for example), import Anzar and create your auth instance
+
+```typescript 
+// Initialize once at application startup
+// The SDK will communicate with your Anzar container at the configured api_url
+import { Anzar } from "anzar";
+import anzarConfig from "anzar.yml";
+
+const anzar = Anzar(anzarConfig);
+```
+
+⚠️ **Warning:** 
+    Only extend these functionality if you are using **JWT** authentication
+
+⚠️ **Warning:** Implement a secure Storage solution
+
+```typescript 
+import { SessionTokens } from "anzar.types";
+const anzar = Anzar(anzarConfig, {
+  getToken: () => "AccessToken",
+  getRefreshToken: () => "RefreshToken",
+  onTokenRefresh(tokens) =>  //store tokens.access, tokens.refresh,
+  ...
+});
+```
+
+## Basic Usage
+Anzar provides authentication support for email and password.
+
+📝 **Note:** Other methods of authentication will be implemented later
+
+### Sign Up
+To sign up a user you need to call the method register with the user's information.
+```typescript
+try {
+    const response = await anzar.Auth.register({ username, email, password });
+    const data: AuthResponse = response.data;
+    if (data.tokens) {
+        // Store securely the `access`,`refresh` tokens
+    }
+} catch (e) {
+    const message = e.response?.data?.message ?? "An unknown error occurred";
+    console.log(message);
+}
+```
+
+📝 **Note:** By default, the users are automatically signed in after they successfully sign up.
+             Disabling this behavior will be implemented later
+
+### Sign In
+To sign in a user you need to call the method login.
+```typescript
+try {
+    const response = await anzar.Auth.login({ email, password });
+    const data: AuthResponse = response.data;
+    if (data.tokens) {
+        // Store securely the `access`,`refresh` tokens
+    }
+} catch (e) {
+    const message = e.response?.data?.message ?? "An unknown error occurred";
+    console.log(message);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "anzar",
-	"version": "1.2.7",
+	"version": "1.2.9",
 	"description": "Anzar SDK",
 	"type": "module",
 	"main": "./dist/index.cjs",