hivewrite-sdk 1.1.47 → 1.1.48

package/README.md

@@ -50,10 +50,12 @@ const MyEditor = () => {
   useEffect(() => {
     if (containerRef.current) {
       hivewrite.init({
-        authorize: async () => {
+        accessToken: "initial_access_token_here",
+        onTokenRefresh: async () => {
           // Best practice: Fetch from your backend to keep API key secure
-          const response = await fetch("/api/hivewrite/authorize");
-          return await response.json(); // Must return AuthData structure
+          const response = await fetch("/api/hivewrite/refresh-token");
+          const data = await response.json();
+          return data.access_token; // Return the new access token string
         },
         container: containerRef.current,
         mode: "FULL_EDITOR",
@@ -79,9 +81,11 @@ const MyEditor = () => {
 <script src="https://cdn.jsdelivr.net/npm/hivewrite-sdk@latest/bundle.min.js"></script>
 <script>
   hivewrite.init({
-    authorize: async () => {
-      const response = await fetch("/api/hivewrite/authorize");
-      return await response.json();
+    accessToken: "initial_access_token_here",
+    onTokenRefresh: async () => {
+      const response = await fetch("/api/hivewrite/refresh-token");
+      const data = await response.json();
+      return data.access_token;
     },
     container: "#editor-container",
     mode: "FULL_EDITOR",
@@ -107,8 +111,9 @@ Initializes and mounts the editor.
 
 | Parameter      | Type                    | Required | Description                                                                                                                                         |
 | :------------- | :---------------------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `authorize`    | `() => Promise<AuthData>` | Yes      | Callback function that returns authorization data (token and account info)                                                                         |
-| `container`    | `string \| HTMLElement` | Yes      | CSS selector or DOM element to mount the editor                                                                                                     |
+| `onTokenRefresh` | `() => Promise<string>` | Yes      | Callback function that returns a new access token when the current one expires                                                                         |
+| `accessToken`    | `string`                | Yes      | Initial access token for authorization                                                                                                              |
+| `container`      | `string \| HTMLElement` | Yes      | CSS selector or DOM element to mount the editor                                                                                                     |
 | `userId`       | `string`                | No       | Unique identifier for the current user                                                                                                              |
 | `mode`         | `string`                | Yes      | `'FULL_EDITOR'`, `'DESIGN_ONLY'`, `'READ_ONLY'`                                                                                                     |
 | `theme`        | `string`                | No       | `'light'` (default) or `'dark'`                                                                                                                     |
@@ -144,20 +149,22 @@ Initializes and mounts the editor.
 
 ## 🔐 Authentication & Security
 
-HiveWrite uses a callback-based authentication system to ensure your API keys are never exposed in the client-side code.
+HiveWrite uses a dual-token authentication system: you provide an initial token and a callback to refresh it.
 
-### 1. The `authorize` Callback
+### 1. The `onTokenRefresh` Callback
 
-You must provide an `authorize` function that returns a `Promise` resolving to `AuthData`.
+You must provide an `onTokenRefresh` function that returns a `Promise` resolving to a new access token string.
 
 ```javascript
 import { EmailEditor } from "hivewrite-sdk";
 
 EmailEditor.init({
-  authorize: async () => {
-    // Call your backend proxy
-    const res = await fetch("/api/hivewrite-auth");
-    return await res.json();
+  accessToken: "initial_token",
+  onTokenRefresh: async () => {
+    // Call your backend proxy to get a fresh token
+    const res = await fetch("/api/hivewrite-refresh");
+    const data = await res.json();
+    return data.access_token;
   },
   // ... other config
 });