hivewrite-sdk 1.1.9 → 1.1.11

package/README.md

@@ -15,7 +15,8 @@ A powerful, flexible, and easy-to-integrate drag-and-drop email builder for Reac
 - 🎯 **Merge Tags** - Dynamic content placeholders for personalization
 - 🖼️ **Stock Images** - Built-in Unsplash integration for stock photos
 - 🏗️ **Pre-built Templates** - E-commerce, marketing, and transactional email templates
-- 🔧 **Fully Customizable** - White-labeling, permissions, and branding options
+- � **Saved Sections** - Save and reuse custom block groups across templates
+- �🔧 **Fully Customizable** - White-labeling, permissions, and branding options
 
 ---
 
@@ -54,7 +55,6 @@ const MyEditor = () => {
         locale: 'en',
         callbacks: {
           onLoad: () => console.log('Editor ready'),
-          onSave: (design) => console.log('Saved:', design),
           onExport: (html) => console.log('HTML:', html)
         }
       });
@@ -80,7 +80,6 @@ const MyEditor = () => {
         locale: 'en',
         callbacks: {
             onLoad: () => console.log('Editor ready'),
-            onSave: (design) => console.log('Saved:', design),
             onExport: (html) => console.log('HTML:', html)
         }
     });
@@ -106,8 +105,9 @@ Initializes and mounts the editor.
 | `theme` | `string` | No | `'light'` (default) or `'dark'` |
 | `locale` | `string` | No | `'en'` (default), `'es'`, or `'fr'` |
 | `branding` | `object` | No | Custom white-labeling options |
-| `permissions` | `object` | No | Toggle features: `exportHTML`, `aiMagic`, `uploadImages` |
+| `permissions` | `object` | No | Toggle features: `export`, `aiMagic`, `uploadImages` |
 | `mergeTags` | `array` | No | Array of `{ label, value }` for dynamic content |
+| `portalTarget` | `string` | No | `'window'` (default) or `'container'`. Controls where dialogs render. |
 | `callbacks` | `object` | No | Event hooks for SDK actions |
 
 ---
@@ -192,7 +192,7 @@ Control what features are available:
 
 ```javascript
 permissions: {
-  exportHTML: true,       // Allow HTML export
+  export: true,       // Allow HTML export
   aiMagic: true,          // Enable AI features
   uploadImages: false     // Disable uploads (stock images only)
 }
@@ -219,8 +219,7 @@ mergeTags: [
 | Callback | Arguments | Description |
 | :--- | :--- | :--- |
 | `onLoad` | `()` | Editor fully initialized |
-| `onSave` | `(json: any, userId?: string)` | User saves or `saveDesign` called |
-| `onExport` | `(html: string, userId?: string)` | User exports or `exportHtml` called |
+| `onExport` | `(html: string, userId?: string)` | User exports or `export` called |
 | `onError` | `(err: any, userId?: string)` | Initialization or processing error |
 | `onTemplateChange` | `(templateId: string, userId?: string)` | Template selection changed |
 | `onImageUpload` | `(file: File, userId?: string)` | **Async**. Handle image uploads, return URL |
@@ -241,10 +240,14 @@ callbacks: {
 
 ### Response Examples
 
-#### `onSave(design, userId)`
-The `design` object contains the full state of the editor.
+#### `hivewrite.save()`
+Returns the current design state as a JSON object.
 
 ```javascript
+const design = hivewrite.save();
+console.log(design);
+
+// Output:
 {
   "blocks": [ ... ],       // Array of block objects
   "canvasSettings": { ... }, // Canvas styles (width, background, etc)
@@ -297,7 +300,7 @@ Exported HTML is fully compatible with:
 | :--- | :--- |
 | `init(config)` | Initialize the editor |
 | `export({ format, minify?, inlineCSS? })` | Export design to HTML or JSON |
-| `saveTemplate({ name })` | Save as reusable template |
+| `save()` | Save current design state to JSON |
 | `importHTML({ html })` | Import HTML into editor (experimental) |
 | `setTheme(theme)` | Switch theme at runtime |
 | `setUserId(userId)` | Update user ID at runtime |