@useinsider/guido 1.0.0-beta.5790a04 → 1.0.0-beta.5ca5e28

package/README.md

@@ -1,33 +1,25 @@
-<p align="center">
-  <a href="https://www.youtube.com/shorts/Y0RwBeMezL4" target="_blank" rel="noopener noreferrer">
-    <img width="180" src="./public/guido.png" alt="Guido logo">
-  </a>
-</p>
+# @useinsider/guido-plugin
 
-
-# @useinsider/guido
-
-Guido is a Vue 2 + TypeScript wrapper for the Stripo Email Editor plugin. Easily embed the professional email editor in your Vue applications with a clean, customizable interface.
+Guido is a Vue + TypeScript wrapper for Email Plugin. Easily embed the email editor in your Vue applications.
 
 ## 📦 Install
-
 ```bash
 npm install @useinsider/guido
 ```
 
-## 🚀 Usage
-
-### Basic Usage
-
-```html
+## 🚀 Usage (Vue 2)
+```vue
 <template>
-  <div>
-    <Guido
-      :email-id="emailId"
-      :user-id="userId"
-      :guido-config="guidoConfig"
-    />
-  </div>
+  <Guido
+    email-id="abc123"
+    :api="apiEndpoints"
+    :extensions="extensions"
+    :insider-stripo-config="insiderStripoConfig"
+    @save="handleSave"
+    @export:requested="onExportRequested"
+    @export:ready="handleHtml"
+    @close="onClose"
+  />
 </template>
 
 <script lang="ts">
@@ -39,186 +31,99 @@ export default {
   },
   data() {
     return {
-      emailId: 'abc123',
-      userId: '12345',
-      guidoConfig: {
-        translationsPath: 'window.trans.en'
+      apiEndpoints: {
+        dynamicContent: '/api/dynamic-content',
+        unsubPages: '/api/unsub-pages',
+        header: '/api/header',
+        footer: '/api/footer',
+        productName: '/api/product-name',
+        productVersion: '/api/product-version',
+        token: '/api/stripo-token'
+      },
+      extensions: {
+        dynamicContent: true,
+        unsubPages: true,
+        header: false,
+        footer: false
       }
     };
+  },
+  methods: {
+    handleSave(data: any) {
+      console.log('Saved:', data);
+    },
+    handleHtml({ html }: { html: string }) {
+      console.log('HTML ready:', html);
+    },
+    onExportRequested() {
+      console.log('Export started');
+    },
+    onClose() {
+      console.log('Closed');
+    }
   }
 };
 </script>
 ```
 
 ## 📚 API
+### `<StripoEditor />` Props
+| Prop        | Type     | Required | Description                |
+|-------------|----------|----------|----------------------------|
+| emailId     | string   | ✅       | Stripo email draft ID     |
+| iframeId    | string   | ❌       | Custom iframe ID          |
+| api         | object   | ❌       | Custom API endpoints      |
+| extensions  | object   | ❌       | Enable/disable extensions |
+| insiderStripoConfig | object | ❌ | Insider Stripo configuration |
+
+### Extensions
+| Extension       | Type      | Default | Description                    |
+|----------------|-----------|---------|--------------------------------|
+| dynamicContent | boolean   | true    | Dynamic content functionality  |
+| unsubPages     | boolean   | true    | Unsubscribe pages feature      |
+| header         | boolean   | true    | Header customization           |
+| footer         | boolean   | true    | Footer customization           |
+
+### Insider Stripo Configuration
+| Property          | Type     | Default | Description                    |
+|-------------------|----------|---------|--------------------------------|
+| translationsPath  |  string  | 'window.trans.en | JS Path to translations file |
+
+### API Endpoints
+| Endpoint           | Default Path           | Description                    |
+|-------------------|------------------------|--------------------------------|
+| dynamicContent    | /api/dynamic-content   | Dynamic content endpoint       |
+| unsubPages        | /api/unsub-pages       | Unsubscribe pages endpoint     |
+| header            | /api/header            | Header endpoint                |
+| footer            | /api/footer            | Footer endpoint                |
+| productName       | /api/product-name      | Product name endpoint          |
+| productVersion    | /api/product-version   | Product version endpoint       |
+| token             | /api/stripo-token      | Authentication token endpoint  |
+
+### Events
+| Event             | Payload                | Description                    |
+|-------------------|------------------------|--------------------------------|
+| `save`            | any                    | Triggered on save              |
+| `export:requested`| void                   | Triggered when export starts   |
+| `export:ready`    | { html: string }       | Triggered when HTML is ready   |
+| `close`           | void                   | Triggered when editor closes   |
 
-### Guido Component Props
-
-| Prop | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `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 |
-
-### GuidoConfig Interface
-
-```typescript
-interface GuidoConfig {
-  translationsPath: string;
-}
-```
-
-| Property | Type | Default | Description |
-|----------|------|---------|-------------|
-| `translationsPath` | `string` | `'window.trans.en'` | JavaScript path to the translations object |
-
-### TypeScript Types
-
-The library exports the following TypeScript types:
-
-```typescript
-// Main component
-import { Guido } from '@useinsider/guido';
-
-// Types
-import type { GuidoConfig } from '@useinsider/guido';
-import type { StripoEventType } from '@useinsider/guido';
-```
-
-### StripoEventType
-
-```typescript
-type StripoEventType = 
-  | 'save'
-  | 'export'
-  | 'close'
-  | 'autosave'
-  | 'publish'
-  | 'export:requested'
-  | 'export:ready';
-```
 
 ---
 
-## 🔧 Development
-
-### Prerequisites
-
-- 🧄 `Bun` (strongly recommended)
-or
-- NodeJS 18+ & `npm`
-
-### Setup
-
+## 🛠 Development
 ```bash
-# Install dependencies
 bun install
-
-# Start development server
 bun start
-
-# Build for production
-bun run build
-
-# Type checking
-bun run type-check
-
-# Linting
-bun run lint
-```
-
-### Environment Variables
-
-Create a `.env` file with the following variables: (You can get env variables from your senior)
-
-```env
-VITE_STRIPO_PLUGIN_ID=your_plugin_id
-VITE_STRIPO_SECRET_KEY=your_secret_key
-VITE_STRIPO_ROLE=your_role
-```
-
-### Project Structure
-
-```
-src/
-├── components/
-│   ├── Guido.vue                # Main component
-│   └── organisms/
-│       └── header/              # Header components
-│           └── version-history/ # Version History components
-        ...
-├── composables/
-│   ├── useStripo.ts             # Stripo integration
-│   └── useTranslations.ts       # Translation management
-├── @types/
-│   ├── generic.ts               # Generic types
-│   ├── stripo.d.ts              # Stripo-specific types
-│   └── events.ts                # Event types
-├── static/
-│   ├── editor.css               # Custom editor styles
-│   └── templates/
-│       └── default/             # Default email template
-└── library.ts                   # Main export for library
-```
-
-## 🌐 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. 🚀
-Example usage: 
-```js
-import { useTranslations } from '@@/Composables/useTranslations';
-
-const trans = useTranslations();
-
-// use everywhere like this:
-trans('foo.bar')
 ```
 
-## 📦 Build Output
-
-The library builds to multiple formats:
-
-- **ES Module**: `dist/library.js` (recommended)
-- **CSS**: `dist/guido.css` (custom styles)
-
-### Package Exports
-
-```json
-{
-  "exports": {
-    ".": {
-      "import": "./dist/library.js",
-      "types": "./dist/components/Guido.vue.d.ts",
-      "require": "./dist/components/Guido.vue.js"
-    },
-    "./style": "./dist/guido.css"
-  }
-}
+Build & types:
+```bash
+bun run build
 ```
 
-## 🤝 Contributing
-- PR Titles should be structured like `TASK-ID | 🔥 | Some Clear Task Descriptions`
-- PR Labels should be filled.
-- PR Assignee required.
-- Tests should be covered.
-- All required checks should be passed before sending review request.
-
-## 📄 License
-
-ISC License
-
 ---
 
-## 🔗 Related
-
-- [Stripo Email Editor](https://stripo.email/) - The underlying email editor
-- [@useinsider/design-system-vue](https://github.com/useinsider/design-system-vue) - Insider's Vue design system
-
-## 🎯 TODO:
-- [editor.css](src/static/editor.css) should be optimized with variables & `sass-loader`.
-- Master Version Generator should be fixed.
-- Playwright integration
-- Commitlint & Precommit Hooks integration
+TODO: 
+[ ] - Default Template @edugencioglu
+[ ] - Using CSS variables into [editor.css](./src/static/editor.css) @berkansezer-useinsider

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

@@ -1,3 +1,6 @@
-export type GuidoConfig = {
+export type Translations = {
+    [key: string]: string;
+};
+export type InsiderStripoConfig = {
     translationsPath: string;
 };

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

@@ -1,11 +1,5 @@
-import type { GuidoConfig } from '@@/Types/generic';
 type __VLS_Props = {
     emailId: string;
-    userId: string;
-    partnerName?: string;
-    productType?: string;
-    username?: string;
-    guidoConfig: GuidoConfig;
 };
 declare const _default: import("vue").DefineComponent<__VLS_TypePropsToOption<__VLS_Props>, {}, {}, {}, {}, import("vue/types/v3-component-options").ComponentOptionsMixin, import("vue/types/v3-component-options").ComponentOptionsMixin, {}, string, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToOption<__VLS_Props>>>, {}>;
 export default _default;

package/dist/components/Guido.vue.js

@@ -2,17 +2,17 @@ import o from "./Guido.vue2.js";
 /* empty css           */
 import i from "../_virtual/_plugin-vue2_normalizer.js";
 var s = function() {
-  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(
+  var t = this, r = t._self._c, e = t._self._setupProxy;
+  return r("div", { staticClass: "guido-editor-wrapper" }, [r(e.Header), r("div", { staticClass: "guido-editor-container", attrs: { id: "guido-editor" } })], 1);
+}, a = [], n = /* @__PURE__ */ i(
   o,
   s,
-  _,
+  a,
   !1,
   null,
-  "d4a5c957"
+  "c14163ad"
 );
-const f = a.exports;
+const f = n.exports;
 export {
   f as default
 };

package/dist/components/Guido.vue2.js

@@ -1,43 +1,24 @@
-import { defineComponent as f, onMounted as c } from "vue";
-import { usePartner as g } from "../composables/usePartner.js";
-import { useStripo as _ } from "../composables/useStripo.js";
-import { useTemplates as y } from "../composables/useTemplates.js";
-import { DefaultUsername as C, DefaultGuidoConfig as T } from "../enums/defaults.js";
-import w from "./organisms/header/HeaderWrapper.vue.js";
-const h = /* @__PURE__ */ f({
+import { defineComponent as a, onMounted as n } from "vue";
+import { useStripo as m } from "../composables/useStripo.js";
+import { useTemplates as p } from "../composables/useTemplates.js";
+import s from "./organisms/top-bar/Header.vue.js";
+const f = /* @__PURE__ */ a({
   __name: "Guido",
   props: {
-    emailId: null,
-    userId: null,
-    partnerName: null,
-    productType: null,
-    username: null,
-    guidoConfig: null
+    emailId: null
   },
-  setup(d) {
-    const o = d, { getPartnerName: r, getProductType: t } = g(), {
-      emailId: n,
-      userId: i,
-      guidoConfig: a,
-      partnerName: u = r(),
-      productType: p = t(),
-      username: m = C
-    } = o;
-    window.GuidoConfig = {
-      ...T,
-      ...a
-    };
-    const { initPlugin: l } = _({ emailId: n, userId: i, username: m, partnerName: u, productType: p }), { getDefaultTemplate: s } = y();
-    return c(async () => {
+  setup(i) {
+    const e = i, { initPlugin: o } = m(e.emailId), { getDefaultTemplate: r } = p();
+    return n(async () => {
       try {
-        const e = await s();
-        await l(e);
-      } catch (e) {
-        console.error("Failed to initialize Stripo editor:", e);
+        const t = await r();
+        await o(t);
+      } catch (t) {
+        console.error("Failed to initialize Stripo editor:", t);
       }
-    }), { __sfc: !0, props: o, getPartnerName: r, getProductType: t, emailId: n, userId: i, guidoConfig: a, partnerName: u, productType: p, username: m, initPlugin: l, getDefaultTemplate: s, HeaderWrapper: w };
+    }), { __sfc: !0, props: e, initPlugin: o, getDefaultTemplate: r, Header: s };
   }
 });
 export {
-  h as default
+  f as default
 };

package/dist/components/organisms/{header/HeaderWrapper.vue.js → top-bar/Header.vue.js}

@@ -1,17 +1,17 @@
-import t from "./HeaderWrapper.vue2.js";
+import t from "./Header.vue2.js";
 import s from "../../../_virtual/_plugin-vue2_normalizer.js";
-var n = function() {
+var a = function() {
   var o = this, r = o._self._c, e = o._self._setupProxy;
-  return r(e.InContainer, { attrs: { border: "bor-w-0 bor-b-w-1 bor-s-s bor-c-6", "border-radius": "bor-r-0" } }, [r("div", { staticClass: "w-1 d-f a-i-c j-c-s-b p-3" }, [r(e.LeftSlot), r(e.MiddleSlot), r(e.RightSlot)], 1)]);
-}, a = [], _ = /* @__PURE__ */ s(
+  return r(e.InContainer, { attrs: { border: "bor-w-0 bor-b-w-1 bor-s-s bor-c-6", "border-radius": "bor-r-0" } }, [r("div", { staticClass: "w-1 d-f a-i-c j-c-s-b p-3" }, [r(e.HeaderLeftSlot), r(e.HeaderMiddleSlot), r(e.HeaderRightSlot)], 1)]);
+}, n = [], _ = /* @__PURE__ */ s(
   t,
-  n,
   a,
+  n,
   !1,
   null,
   null
 );
-const d = _.exports;
+const c = _.exports;
 export {
-  d as default
+  c as default
 };

package/dist/components/organisms/top-bar/Header.vue2.js

@@ -0,0 +1,14 @@
+import { defineComponent as e } from "vue";
+import { InContainer as r } from "@useinsider/design-system-vue";
+import o from "./HeaderLeftSlot.vue.js";
+import t from "./HeaderMiddleSlot.vue.js";
+import m from "./HeaderRightSlot.vue.js";
+const _ = /* @__PURE__ */ e({
+  __name: "Header",
+  setup(f) {
+    return { __sfc: !0, InContainer: r, HeaderLeftSlot: o, HeaderMiddleSlot: t, HeaderRightSlot: m };
+  }
+});
+export {
+  _ as default
+};

package/dist/components/organisms/{header/LeftSlot.vue.js → top-bar/HeaderLeftSlot.vue.js}

@@ -1,17 +1,17 @@
-import r from "./LeftSlot.vue2.js";
+import n from "./HeaderLeftSlot.vue2.js";
 import o from "../../../_virtual/_plugin-vue2_normalizer.js";
 var _ = function() {
-  var t = this, e = t._self._c, n = t._self._setupProxy;
-  return e("div", [e(n.InButtonV2, { attrs: { id: "guido__back-button", "label-text": "Back", "left-icon": "line-arrow-left", styling: "text", type: "secondary" } })], 1);
-}, s = [], a = /* @__PURE__ */ o(
-  r,
+  var t = this, e = t._self._c, r = t._self._setupProxy;
+  return e("div", [e(r.InButtonV2, { attrs: { id: "guido__back-button", "label-text": "Back", "left-icon": "line-arrow-left", styling: "text", type: "secondary" } })], 1);
+}, a = [], s = /* @__PURE__ */ o(
+  n,
   _,
-  s,
+  a,
   !1,
   null,
   null
 );
-const i = a.exports;
+const i = s.exports;
 export {
   i as default
 };

package/dist/components/organisms/top-bar/HeaderLeftSlot.vue2.js

@@ -0,0 +1,11 @@
+import { defineComponent as t } from "vue";
+import { InButtonV2 as e } from "@useinsider/design-system-vue";
+const _ = /* @__PURE__ */ t({
+  __name: "HeaderLeftSlot",
+  setup(o) {
+    return { __sfc: !0, InButtonV2: e };
+  }
+});
+export {
+  _ as default
+};

package/dist/components/organisms/top-bar/HeaderMiddleSlot.vue.js

@@ -0,0 +1,17 @@
+import o from "./HeaderMiddleSlot.vue2.js";
+import s from "../../../_virtual/_plugin-vue2_normalizer.js";
+var l = function() {
+  var n = this, t = n._self._c, e = n._self._setupProxy;
+  return t("div", { staticClass: "d-f" }, [t(e.InButtonV2, { attrs: { id: "guido__undo-button", "left-icon": "line-undo", styling: "ghost", type: "secondary", "label-text-status": !1 } }), t(e.InButtonV2, { attrs: { id: "guido__redo-button", "left-icon": "line-redo", styling: "ghost", type: "secondary", "label-text-status": !1 } }), t(e.InButtonV2, { attrs: { id: "guido__code-button", "left-icon": "line-code", styling: "ghost", type: "secondary", "label-text-status": !1 } }), t(e.InButtonV2, { attrs: { id: "guido__preview-button", "left-icon": "line-show-on", styling: "ghost", type: "secondary", "label-text-status": !1 } })], 1);
+}, a = [], i = /* @__PURE__ */ s(
+  o,
+  l,
+  a,
+  !1,
+  null,
+  null
+);
+const _ = i.exports;
+export {
+  _ as default
+};

package/dist/components/organisms/top-bar/HeaderMiddleSlot.vue2.js

@@ -0,0 +1,11 @@
+import { defineComponent as e } from "vue";
+import { InButtonV2 as t } from "@useinsider/design-system-vue";
+const _ = /* @__PURE__ */ e({
+  __name: "HeaderMiddleSlot",
+  setup(o) {
+    return { __sfc: !0, InButtonV2: t };
+  }
+});
+export {
+  _ as default
+};

package/dist/components/organisms/top-bar/HeaderRightSlot.vue.js

@@ -0,0 +1,18 @@
+import n from "./HeaderRightSlot.vue2.js";
+/* empty css                     */
+import o from "../../../_virtual/_plugin-vue2_normalizer.js";
+var a = function() {
+  var s = this, t = s._self._c, e = s._self._setupProxy;
+  return t("div", { staticClass: "d-f header-right-slot" }, [t("div", { staticClass: "d-f" }, [t(e.InSegments, { attrs: { id: "preview-platform-selection", "with-icon": "", selected: "desktop", "segment-list": e.segmentList } })], 1), t("div", { staticClass: "d-f" }, [t(e.InButtonV2, { attrs: { id: "guido__history-button", "left-icon": "line-architect-version-history", styling: "ghost", type: "secondary", "label-text-status": !1 } }), t(e.InButtonV2, { attrs: { id: "guido__export-button", "left-icon": "line-export", styling: "ghost", type: "secondary", "label-text-status": !1 } }), t(e.InButtonV2, { attrs: { id: "guido__save-as-button", "left-icon": "line-newsletter-save-as-template", styling: "ghost", type: "secondary", "label-text-status": !1 } }), t(e.InButtonV2, { attrs: { id: "guido__test-button", "left-icon": "line-architect-test-journey", styling: "ghost", type: "secondary", "label-text-status": !1 } })], 1), t(e.InButtonV2, { attrs: { id: "guido__save-button", "label-text": "Save" } })], 1);
+}, i = [], l = /* @__PURE__ */ o(
+  n,
+  a,
+  i,
+  !1,
+  null,
+  "9d879f6f"
+);
+const u = l.exports;
+export {
+  u as default
+};

package/dist/components/organisms/top-bar/HeaderRightSlot.vue2.js

@@ -0,0 +1,14 @@
+import { defineComponent as e } from "vue";
+import { InSegments as t, InButtonV2 as n } from "@useinsider/design-system-vue";
+const p = /* @__PURE__ */ e({
+  __name: "HeaderRightSlot",
+  setup(o) {
+    return { __sfc: !0, segmentList: [
+      { text: "", icon: "line-desktop", value: "desktop" },
+      { text: "", icon: "line-menu-mobileapp", value: "mobile" }
+    ], InButtonV2: n, InSegments: t };
+  }
+});
+export {
+  p as default
+};

package/dist/composables/useStripo.d.ts

@@ -1,4 +1,4 @@
-import type { Metadata, Template } from '@@/Types/stripo';
-export declare const useStripo: (metadata: Metadata) => {
+import type { Template } from '@@types/stripo';
+export declare const useStripo: (emailId: string) => {
     initPlugin: (template: Template) => Promise<void>;
 };