@useinsider/guido 1.0.0-beta.35d2ac4 → 1.0.0-beta.3bcd23c

package/README.md

@@ -14,10 +14,7 @@ Guido is a Vue 2 + TypeScript wrapper for the Stripo Email Editor plugin. Easily
 ```bash
 npm install @useinsider/guido
 ```
-### Prerequisites
-  🍍 Your project should have `pinia`
 
----
 ## 🚀 Usage
 
 ### Basic Usage
@@ -26,16 +23,9 @@ npm install @useinsider/guido
 <template>
   <div>
     <Guido
-      ref="guidoEditor"
-      :template-id="templateId"
+      :email-id="emailId"
       :user-id="userId"
       :guido-config="guidoConfig"
-      :html="initialHtml"
-      :css="initialCss"
-      @dynamic-content:open="handleDynamicContentOpen"
-      @back="handleBack"
-      @save:start="handleSaveStart"
-      @save:complete="handleSaveComplete"
     />
   </div>
 </template>
@@ -49,55 +39,12 @@ export default {
   },
   data() {
     return {
-      templateId: 'template-123',
-      userId: 'user-456',
-      initialHtml: '<p>Initial HTML content</p>',
-      initialCss: 'p { color: #333; }',
+      emailId: 'abc123',
+      userId: '12345',
       guidoConfig: {
-        translationsPath: 'window.trans.en',
-        htmlCompilerRules: [],
-        ignoreDefaultHtmlCompilerRules: false,
-      },
-      dynamicContentModalVisible: false
+        translationsPath: 'window.trans.en'
+      }
     };
-  },
-
-  methods: {
-    handleDynamicContentOpen(detail) {
-      console.log('Dynamic content requested:', detail);
-      this.dynamicContentModalVisible = true;
-    },
-    
-    handleBack() {
-      console.log('User clicked back button');
-      // Handle navigation back
-    },
-    
-    handleSaveStart() {
-      console.log('Save process started');
-      // Show loading indicator
-    },
-    
-    handleSaveComplete(template) {
-      console.log('Save completed:', template);
-      // Handle saved template data
-    },
-    
-    // ⚠️ Your own Dynamic Content Modal should have this id: #guido-dynamic-content-modal
-    handleDynamicContentInsert() {
-      this.$refs.guidoEditor?.dynamicContent.insert({
-        text: 'Display Text', 
-        value: 'actual-value', 
-        fallback: 'Fallback Text'
-      });
-
-      this.dynamicContentModalVisible = false;
-    },
-    
-    // ⚠️ It's mandatory. There is no way to understand if user closes the modal without selection.
-    handleDynamicContentClose() {
-      this.$refs.guidoEditor?.dynamicContent.close();
-    }
   }
 };
 </script>
@@ -109,60 +56,24 @@ export default {
 
 | Prop | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
-| `templateId` | `string` | ✅ | - | Unique identifier for the email template |
-| `userId` | `string` | ✅ | - | Unique identifier for the user |
+| `emailId` | `string` | ✅ | - | Unique identifier for the email draft |
+| `userId` | `string` | ✅ | - | Unique identifier for the user draft |
+| `username` | `string` | ⚪ | Guido User | User name |
+| `partnerName` | `string` | ⚪ | Getting from URL host | Unique identifier for the partner draft |
+| `productType` | `string` | ⚪ | Getting from URL path | Unique identifier for the product draft |
 | `guidoConfig` | `GuidoConfig` | ✅ | - | Configuration object for the editor |
-| `partnerName` | `string` | ⚪ | From URL host | Partner identifier |
-| `productType` | `string` | ⚪ | From URL path | Product type identifier |
-| `username` | `string` | ⚪ | `'Guido User'` | Display name for the user |
-| `html` | `string` | ⚪ | `''` | Initial HTML content for the template |
-| `css` | `string` | ⚪ | `''` | Initial CSS styles for the template |
-
-### Guido Component Events
-
-| Event | Payload | Description |
-|-------|---------|-------------|
-| `dynamic-content:open` | `DynamicContent \| null` | Fired when user requests to insert dynamic content |
-| `back` | - | Fired when user clicks the back button |
-| `save:start` | - | Fired when the save process begins |
-| `save:complete` | `Omit<Template, 'forceRecreate'>` | Fired when template is successfully saved |
-
-### Guido Exposed Methods
-```typescript
-dynamicContent.insert(DynamicContent);
-dynamicContent.close();
-```
 
-### Guido Interfaces
+### GuidoConfig Interface
 
 ```typescript
 interface GuidoConfig {
   translationsPath: string;
-  htmlCompilerRules: CompilerRule[];
-  ignoreDefaultHtmlCompilerRules: boolean;
 }
 ```
 
 | Property | Type | Default | Description |
 |----------|------|---------|-------------|
 | `translationsPath` | `string` | `'window.trans.en'` | JavaScript path to the translations object |
-| `htmlCompilerRules` | `CompilerRule[]` | `[]` | Additional compiler rules to apply to HTML content. See [HTML Compiler Rules](#-html-compiler-rules) section below |
-| `ignoreDefaultHtmlCompilerRules` | `boolean` | `false` | Skip default compiler rules and only use custom rules. Default rules: `src/config/compiler/htmlCompilerRules.ts` |
-
-```typescript
-interface DynamicContent {
-  value: string;
-  text: string;
-  fallback?: string;
-}
-```
----
-
-| Property | Type | Default | Description |
-|----------|------|---------|-------------|
-| `value` | `string` | '' | Value of the dynamic content |
-| `text` | `string` | '' | Visible value of the dynamic content |
-| `fallback?` | `string` | '' | Fallback value of the dynamic content. Optional |
 
 ### TypeScript Types
 
@@ -177,183 +88,17 @@ import type { GuidoConfig } from '@useinsider/guido';
 import type { StripoEventType } from '@useinsider/guido';
 ```
 
-## 🔨 HTML Compiler Rules
-
-Guido includes a powerful HTML compiler system that allows you to transform HTML content with custom rules. You can define additional rules and optionally ignore the default rules.
-
-### Rule Types
-
-There are 4 types of compiler rules:
-
-#### 1. Replace Rule
-Replace specific strings in HTML content.
-
-```typescript
-{
-  id: 'fix-encoding',
-  description: 'Fix URL encoding issues',
-  type: 'replace',
-  search: '{%22',           // String to find
-  replacement: '%7B%22',    // String to replace with
-  replaceAll: true,         // Replace all occurrences (default: true)
-  priority: 10              // Execution priority (lower = earlier)
-}
-```
-
-#### 2. Regex Rule
-Use regular expressions for complex pattern matching and replacement.
-
-```typescript
-{
-  id: 'remove-comments',
-  description: 'Remove HTML comments',
-  type: 'regex',
-  pattern: '<!--.*?-->',    // Regex pattern
-  replacement: '',          // Replacement string
-  flags: 'g',              // Regex flags (default: 'g')
-  priority: 20
-}
-```
-
-#### 3. Remove Rule
-Remove specific strings or patterns from HTML content.
-
-```typescript
-{
-  id: 'cleanup-scripts',
-  description: 'Remove unwanted script tags',
-  type: 'remove',
-  targets: [                              // Array of strings or RegExp objects
-    '<script src="unwanted.js"></script>',
-    /onclick="[^"]*"/g
-  ],
-  priority: 30
-}
-```
-
-#### 4. Custom Rule
-Define complex transformation logic with a custom processor function.
-
-```typescript
-{
-  id: 'add-meta-tags',
-  description: 'Add custom meta tags to head',
-  type: 'custom',
-  processor: (html: string): string => {
-    // Custom transformation logic
-    const metaTags = '<meta name="custom" content="value">';
-    return html.replace('</head>', `${metaTags}</head>`);
-  },
-  priority: 40
-}
-```
-
-### Using HTML Compiler Rules
-
-#### Basic Usage with Custom Rules
-
-```typescript
-const guidoConfig = {
-  translationsPath: 'window.trans.en',
-  htmlCompilerRules: [
-    {
-      id: 'replace-domain',
-      description: 'Replace old domain with new one',
-      type: 'replace',
-      search: 'old-domain.com',
-      replacement: 'new-domain.com',
-      replaceAll: true,
-      priority: 10
-    },
-    {
-      id: 'remove-tracking',
-      description: 'Remove tracking pixels',
-      type: 'regex',
-      pattern: '<img[^>]*tracking[^>]*>',
-      replacement: '',
-      flags: 'gi',
-      priority: 20
-    }
-  ]
-};
-```
-
-#### Ignoring Default Rules
-
-```typescript
-const guidoConfig = {
-  translationsPath: 'window.trans.en',
-  ignoreDefaultHtmlCompilerRules: true, // Skip all default rules
-  htmlCompilerRules: [
-    // Only your custom rules will be applied
-    {
-      id: 'custom-transformation',
-      type: 'replace',
-      search: 'old-text',
-      replacement: 'new-text',
-      priority: 1
-    }
-  ]
-};
-```
-
-### Rule Execution Order
-
-Rules are executed in priority order (lower numbers first). Rules with the same priority are executed in array order.
-
-- **Priority 1-99**: Reserved for critical transformations
-- **Priority 100-999**: Standard transformations  
-- **Priority 1000+**: Additional custom rules (automatically assigned)
-
-### Default Rules
-
-Guido includes several default rules for common email HTML optimizations:
-
-- **URL encoding fixes**: Fixes malformed URL encoding in dynamic content
-- **Template tag restoration**: Restores `{{}}` template tags that got URL encoded
-- **HTML entity decoding**: Converts `&lt;` and `&gt;` back to `<` and `>`
-- **Cleanup rules**: Removes unwanted iframe and style elements
-- **MSO conditions**: Manages Outlook-specific conditional comments
-- **Domain replacement**: Updates old image domains to current ones
-
-You can view all default rules in: `src/config/compiler/htmlCompilerRules.ts`
-
-### CompilerRule Interface
+### StripoEventType
 
 ```typescript
-type CompilerRuleType = 'replace' | 'regex' | 'remove' | 'custom';
-
-interface BaseCompilerRule {
-  id: string;
-  description?: string;
-  priority: number;
-}
-
-interface ReplaceRule extends BaseCompilerRule {
-  type: 'replace';
-  search: string;
-  replacement: string;
-  replaceAll?: boolean; // Default: true
-}
-
-interface RegexRule extends BaseCompilerRule {
-  type: 'regex';
-  pattern: string;
-  replacement: string;
-  flags?: string; // Default: 'g'
-}
-
-interface RemoveRule extends BaseCompilerRule {
-  type: 'remove';
-  targets: (string | RegExp)[]; // Array of strings or RegExp objects
-}
-
-interface CustomRule extends BaseCompilerRule {
-  type: 'custom';
-  processor: (html: string) => string;
-}
-
-type CompilerRule = ReplaceRule | RegexRule | RemoveRule | CustomRule;
+type StripoEventType = 
+  | 'save'
+  | 'export'
+  | 'close'
+  | 'autosave'
+  | 'publish'
+  | 'export:requested'
+  | 'export:ready';
 ```
 
 ---
@@ -412,87 +157,6 @@ src/
 └── library.ts          # Main export
 ```
 
-## 🔌 Provide/Inject Utilities
-
-Guido includes type-safe utilities for Vue's provide/inject system to facilitate dependency injection between components.
-
-### useProvideInject
-
-The `useProvideInject` composable provides two helper functions for type-safe dependency injection:
-
-#### Basic Usage
-
-```typescript
-// Parent component
-import { provideValue } from '@useinsider/guido';
-import { InjectionKey } from 'vue';
-
-// Define a typed injection key
-const MyServiceKey: InjectionKey<MyService> = Symbol('MyService');
-
-// Provide the value
-const myService = new MyService();
-provideValue(MyServiceKey, myService);
-
-// Child component
-import { useInjectedValue } from '@useinsider/guido';
-
-// Inject the value with type safety
-const myService = useInjectedValue(MyServiceKey);
-```
-
-#### With Default Value
-
-```typescript
-// Inject with a fallback value
-const myService = useInjectedValue(MyServiceKey, new DefaultService());
-```
-
-#### Error Handling
-
-The `useInjectedValue` function will throw a descriptive error if no provider is found and no default value is provided:
-
-```typescript
-// This will throw an error if no provider exists
-try {
-  const myService = useInjectedValue(MyServiceKey);
-} catch (error) {
-  console.error('No provider found for MyService');
-}
-```
-
-### API Reference
-
-#### `provideValue`
-
-```typescript
-provideValue<T>(key: InjectionKey<T>, value: T): void
-```
-
-Provides a value using Vue's provide system with type safety.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `key` | `InjectionKey<T>` | The typed injection key |
-| `value` | `T` | The value to provide |
-
-#### `useInjectedValue`
-
-```typescript
-useInjectedValue<T>(key: InjectionKey<T>, defaultValue?: T): T
-```
-
-Injects a value using Vue's inject system with type safety and error handling.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `key` | `InjectionKey<T>` | ✅ | The typed injection key |
-| `defaultValue` | `T` | ⚪ | Optional fallback value |
-
-**Returns:** `T` - The injected value
-
-**Throws:** `Error` - When no provider is found and no default value is provided
-
 ## 🌐 i18n
 Before running the project, it sends to request to inone.useinsider.com/translations and writes the JSON file into - [trans.json](src/mock/responses/trans.json). 
 It allows to use production or local translations on your code. 🚀
@@ -506,34 +170,6 @@ const trans = useTranslations();
 trans('foo.bar')
 ```
 
-## 📦 Local Building (Recommended)
-
-Run this commands if you want to test the package on your local before sending to NPM.
-```sh
-bun run build
-```
-
-Since bun does not have packaging yet, use npm here: 🥲
-```sh
-npm pack
-```
-
-It'll crate like `useinsider-guido-1.0.0.tgz` file.
-
-Move this file to your project path like: `email-fe` via:
-```sh
-cp useinsider-guido-1.0.0.tgz ../email-fe
-```
-
-Install the file to your project: 
-```sh
-npm i ./useinsider-guido-1.0.0.tgz
-```
-
-Then you just need to rebuild to your project or restart the Container. 🎉
-
-For Future, we can create a shell script for it. Feel free to help 🙃
-
 ## 📦 Build Output
 
 The library builds to multiple formats:
@@ -579,4 +215,8 @@ ISC License
 - Master Version Generator should be fixed.
 - Playwright integration
 - Commitlint & Precommit Hooks integration
+- We need to emit save event and we should return template config to it
+- Default template should be same with production
+- Open Guido with saved template
+- Get User ID, Email and Unique Template ID as dynamic from props
 - Get Pre-built display conditions from API

package/dist/@types/generic.d.ts

@@ -1,15 +1,7 @@
-import type { CompilerRule } from './html-compiler';
 export type GuidoConfig = {
     translationsPath: string;
-    htmlCompilerRules?: CompilerRule[];
-    ignoreDefaultHtmlCompilerRules?: boolean;
 };
 export type DynamicContent = {
     value: string;
     text: string;
-    fallback?: string;
 };
-export interface EmailData {
-    senderName: string;
-    subject: string;
-}

package/dist/components/Guido.vue.d.ts

@@ -1,26 +1,16 @@
-import type { DynamicContent, GuidoConfig, EmailData } from '@@/Types/generic';
-import type { Template } from '@@/Types/stripo';
+import type { DynamicContent, GuidoConfig } from '@@/Types/generic';
 type __VLS_Props = {
-    templateId: string;
+    emailId: string;
     userId: string;
     partnerName?: string;
     productType?: string;
     username?: string;
-    html?: string;
-    css?: string;
     guidoConfig: GuidoConfig;
-    emailData?: EmailData;
 };
 declare const _default: import("vue").DefineComponent<__VLS_TypePropsToOption<__VLS_Props>, {
-    dynamicContent: {
-        insert: (data: DynamicContent) => void;
-        close: () => void;
-    };
+    applyDynamicContent: (data: DynamicContent) => void;
 }, {}, {}, {}, import("vue/types/v3-component-options.js").ComponentOptionsMixin, import("vue/types/v3-component-options.js").ComponentOptionsMixin, {
     "dynamic-content:open": (detail: DynamicContent | null) => void;
-    back: () => void;
-    "save:start": () => void;
-    "save:complete": (template: Omit<Template, "forceRecreate">) => void;
 }, string, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToOption<__VLS_Props>>>, {}>;
 export default _default;
 type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;

package/dist/components/Guido.vue.js

@@ -1,18 +1,18 @@
 import o from "./Guido.vue2.js";
 /* empty css           */
-import t from "../_virtual/_plugin-vue2_normalizer.js";
+import i from "../_virtual/_plugin-vue2_normalizer.js";
 var s = function() {
-  var i = this, r = i._self._c, e = i._self._setupProxy;
-  return r("div", { staticClass: "guido-editor__wrapper" }, [r(e.HeaderWrapper), r(e.EmailPreview, { directives: [{ name: "show", rawName: "v-show", value: e.editorStore.isPreviewModeOpen, expression: "editorStore.isPreviewModeOpen" }], attrs: { "email-data": i.emailData, "is-visible": e.editorStore.isPreviewModeOpen } }), r("div", { directives: [{ name: "show", rawName: "v-show", value: !e.editorStore.isPreviewModeOpen, expression: "!editorStore.isPreviewModeOpen" }], staticClass: "guido-editor__container", attrs: { id: "guido-editor" } })], 1);
-}, a = [], d = /* @__PURE__ */ t(
+  var e = this, r = e._self._c, t = e._self._setupProxy;
+  return r("div", { staticClass: "guido-editor__wrapper" }, [r(t.HeaderWrapper), r("div", { staticClass: "guido-editor__container", attrs: { id: "guido-editor" } })], 1);
+}, _ = [], a = /* @__PURE__ */ i(
   o,
   s,
-  a,
+  _,
   !1,
   null,
-  "7836f831"
+  "67f97212"
 );
-const m = d.exports;
+const f = a.exports;
 export {
-  m as default
+  f as default
 };

package/dist/components/Guido.vue2.js

@@ -1,83 +1,54 @@
-import { defineComponent as w, onMounted as E } from "vue";
-import { provideGuidoActions as S } from "../composables/useGuidoActions.js";
-import { usePartner as D } from "../composables/usePartner.js";
-import { useStripo as _ } from "../composables/useStripo.js";
-import { DefaultUsername as G, DefaultGuidoConfig as I } from "../enums/defaults.js";
-import P from "./organisms/design-preview/EmailPreview.vue.js";
-import k from "./organisms/header/HeaderWrapper.vue.js";
-import { useStripoApi as T } from "../services/stripoApi.js";
-import { useEditorStore as N } from "../stores/editor.js";
-const M = /* @__PURE__ */ w({
+import { defineComponent as C, onMounted as _ } from "vue";
+import { usePartner as w } from "../composables/usePartner.js";
+import { useStripo as T } from "../composables/useStripo.js";
+import { useTemplates as v } from "../composables/useTemplates.js";
+import { DefaultUsername as D, DefaultGuidoConfig as E } from "../enums/defaults.js";
+import I from "./organisms/header/HeaderWrapper.vue.js";
+const x = /* @__PURE__ */ C({
   __name: "Guido",
   props: {
-    templateId: null,
+    emailId: null,
     userId: null,
     partnerName: null,
     productType: null,
     username: null,
-    html: null,
-    css: null,
-    guidoConfig: null,
-    emailData: null
+    guidoConfig: null
   },
-  emits: ["dynamic-content:open", "back", "save:start", "save:complete"],
-  setup(C, { expose: b, emit: t }) {
-    const o = C, { getPartnerName: n, getProductType: a } = D(), {
-      templateId: c,
-      userId: r,
-      guidoConfig: i,
-      html: s = "",
-      css: l = "",
-      partnerName: d = n(),
-      productType: u = a(),
-      username: m = G
-    } = o;
+  emits: ["dynamic-content:open"],
+  setup(y, { expose: g, emit: n }) {
+    const t = y, { getPartnerName: o, getProductType: r } = w(), {
+      emailId: i,
+      userId: a,
+      guidoConfig: c,
+      partnerName: m = o(),
+      productType: u = r(),
+      username: s = D
+    } = t;
     window.GuidoConfig = {
-      ...I,
-      ...i
+      ...E,
+      ...c
     };
-    const { initPlugin: p } = _({ emailId: c, userId: r, username: m, partnerName: d, productType: u }), { getDefaultTemplate: f } = T(), h = N();
-    S({
-      onBack: () => {
-        console.debug("guido:back"), t("back");
-      },
-      onSaveStart: () => {
-        console.debug("guido:save:start"), t("save:start");
-      },
-      onSaveComplete: (e) => {
-        console.debug("guido:save:complete", e), t("save:complete", e);
-      }
-    });
-    const g = (e) => {
-      console.debug("dynamic-content:close", e), document.dispatchEvent(new CustomEvent("dynamic-content:close", { detail: e }));
-    }, y = () => {
-      console.debug("dynamic-content:close", "Without Data"), document.dispatchEvent(new CustomEvent("dynamic-content:close", { detail: { text: "", value: "" } }));
+    const { initPlugin: d } = T({ emailId: i, userId: a, username: s, partnerName: m, productType: u }), { getDefaultTemplate: p } = v(), l = (e) => {
+      console.debug("dynamic-content:close", e), document.dispatchEvent(new CustomEvent("dynamic-content:close", {
+        detail: e
+      }));
     };
-    return E(async () => {
-      console.debug("Guido says happy coding 🎉"), console.debug("🚗 Ka-Chow");
+    return _(async () => {
       try {
-        let e = {
-          html: s,
-          css: l,
-          forceRecreate: !0
-          // TODO: It should be false for old templates. We will communicate with Stripo
-        };
-        e.html || (e = await f()), await p(e);
+        const e = await p();
+        await d(e);
       } catch (e) {
         console.error("Failed to initialize Stripo editor:", e);
       }
       document.addEventListener("dynamic-content:open", (e) => {
-        const v = e;
-        console.debug("dynamic-content:open", v.detail), t("dynamic-content:open", v.detail);
+        const f = e;
+        console.debug("dynamic-content:open", f.detail), n("dynamic-content:open", f.detail);
       });
-    }), b({
-      dynamicContent: {
-        insert: g,
-        close: y
-      }
-    }), { __sfc: !0, props: o, getPartnerName: n, getProductType: a, templateId: c, userId: r, guidoConfig: i, html: s, css: l, partnerName: d, productType: u, username: m, emit: t, initPlugin: p, getDefaultTemplate: f, editorStore: h, insertDynamicContent: g, closeDynamicContent: y, EmailPreview: P, HeaderWrapper: k };
+    }), g({
+      applyDynamicContent: l
+    }), { __sfc: !0, props: t, getPartnerName: o, getProductType: r, emailId: i, userId: a, guidoConfig: c, partnerName: m, productType: u, username: s, emit: n, initPlugin: d, getDefaultTemplate: p, applyDynamicContent: l, HeaderWrapper: I };
   }
 });
 export {
-  M as default
+  x as default
 };

package/dist/components/organisms/header/LeftSlot.vue.js

@@ -1,11 +1,11 @@
-import n from "./LeftSlot.vue2.js";
+import r from "./LeftSlot.vue2.js";
 import o from "../../../_virtual/_plugin-vue2_normalizer.js";
-var r = function() {
-  var e = this, s = e._self._c, t = e._self._setupProxy;
-  return s("div", { staticClass: "d-f a-i-c" }, [s(t.InButtonV2, { staticClass: "p-2", attrs: { id: "guido__back-button", "label-text": "Back", "left-icon": "line-arrow-left", styling: "text", type: "secondary" }, on: { click: t.handleBack } }), t.editorStore.isVersionHistoryOpen ? s(t.RestoreButton, { staticClass: "ml-3" }) : e._e()], 1);
+var n = function() {
+  var t = this, e = t._self._c, s = t._self._setupProxy;
+  return e("div", { staticClass: "d-f a-i-c" }, [e(s.InButtonV2, { staticClass: "p-2", attrs: { id: "guido__back-button", "label-text": "Back", "left-icon": "line-arrow-left", styling: "text", type: "secondary" } }), s.editorStore.isVersionHistoryOpen ? e(s.RestoreButton, { staticClass: "ml-3" }) : t._e()], 1);
 }, a = [], i = /* @__PURE__ */ o(
-  n,
   r,
+  n,
   a,
   !1,
   null,