@useinsider/guido 3.19.0-beta.87e26c0 → 3.19.0-beta.892c3ca

package/README.md

@@ -95,9 +95,11 @@ import type { GuidoConfigInput } from '@useinsider/guido';
 const config: GuidoConfigInput = {
   // Required: Identity
   identity: {
-    templateId: string,      // Required - Template identifier
-    userId: string,          // Required - User identifier
-    variationId?: string,    // Optional - A/B test variation
+    templateId: string,           // Required - Template identifier
+    userId: string,               // Required - User identifier
+    variationId?: string,         // Optional - A/B test variation
+    campaignId?: string,          // Optional - Numeric campaign id; absent for templates/modules
+    templateLibraryId?: string,   // Optional - Numeric template-library id; absent for campaigns/modules
   },
 
   // Required: Partner
@@ -162,6 +164,7 @@ const config: GuidoConfigInput = {
     liquidSyntax?: boolean,       // Default: false - Enable Liquid template syntax
     autosave?: boolean,           // Default: false - Show the Auto Save toggle in the header. See wiki/AUTOSAVE.md.
     allowlistEnabled?: boolean,   // Default: false - Pre-save domain-allowlist check (opt-in). Guido self-serves the block toaster (role lookup, deep-link, copy from window.trans).
+    allowSaveWithErrors?: boolean, // Default: true - Allow the validation drawer's "Save and Continue" soft-save. Set false to hard-block invalid saves (transactional + unsubscribe pages).
     reusableRecommendationStrategy?: boolean, // Default: false - Assign an RRS strategy to recommendation blocks instead of per-block algorithm/filters/shuffle/product-count settings.
   },
 
@@ -184,6 +187,22 @@ const config: GuidoConfigInput = {
 };
 ```
 
+### `identity` ids
+
+`templateId` is the editor's **document** identity (a uuid / Stripo doc id) and never addresses a
+backend resource. `campaignId` and `templateLibraryId` are the **numeric** ids of the surface the
+editor was opened on, and they are what Guido uses to resolve host-scoped endpoints — most visibly
+when converting a legacy recommendation block into a reusable strategy.
+
+| Surface | `campaignId` | `templateLibraryId` |
+|---------|--------------|---------------------|
+| Campaign editor | the campaign id | absent |
+| Saved template editor | absent | the template-library id |
+| Module editor / unsaved template | absent | absent |
+
+Pass only the one that applies. A campaign id takes precedence when both are present, and when
+neither is supplied Guido falls back to campaign scope — so a module keeps working unchanged.
+
 ### `ready` prop
 
 ```vue

package/dist/@types/config/schemas.js

@@ -1,5 +1,5 @@
 import { ModuleFolderDefaults as f } from "../../enums/defaults.js";
-import { object as a, number as n, optional as e, string as t, picklist as i, pipe as m, minLength as b, custom as y, boolean as o, array as c, transform as C, record as k, fallback as R, literal as u, looseObject as g, variant as T, union as h, unknown as r, lazy as I } from "../../node_modules/valibot/dist/index.js";
+import { object as o, number as n, optional as e, string as t, picklist as i, pipe as m, minLength as b, custom as y, boolean as a, array as c, transform as C, record as k, fallback as R, literal as u, looseObject as g, variant as I, union as h, unknown as r, lazy as T } from "../../node_modules/valibot/dist/index.js";
 const p = {
   /** Promotional/marketing emails */
   PROMOTIONAL: 1,
@@ -12,7 +12,7 @@ const p = {
   ARCHITECT: 49,
   /** Unsubscribe page builder */
   UNSUBSCRIBE_PAGES: 97
-}, A = a({
+}, A = o({
   /** Unique identifier for the template being edited */
   templateId: m(
     t(),
@@ -24,13 +24,21 @@ const p = {
     b(1, "userId is required")
   ),
   /** Optional variation ID for A/B testing */
-  variationId: e(t())
-}), L = a({
+  variationId: e(t()),
+  /** Optional numeric campaign ID of the host campaign; absent for templates and modules */
+  campaignId: e(t()),
+  /**
+   * Optional numeric template-library id of the host template; absent for campaigns and
+   * modules. Distinct from `templateId`, which is the editor's document identity (a uuid /
+   * Stripo doc id) and is never an endpoint id.
+   */
+  templateLibraryId: e(t())
+}), L = o({
   /** Fallback font name (e.g., "Georgia") */
   name: t(),
   /** Fallback font family (e.g., "serif" or "sans-serif") */
   family: t()
-}), M = a({
+}), E = o({
   /** Partner/organization name (required) */
   name: m(
     t(),
@@ -54,7 +62,7 @@ const p = {
   username: e(t(), "Guido User"),
   /** Fallback font settings from partner settings — used to match backend size calculation */
   fallbackFont: e(L)
-}), E = a({
+}), M = o({
   /** Display text for the dynamic content */
   text: t(),
   /** Template variable value (e.g., {{username}}) */
@@ -63,12 +71,12 @@ const p = {
   fallback: e(t()),
   /** Optional formatting options */
   format: e(
-    a({
+    o({
       key: t(),
       value: t()
     })
   )
-}), S = I(() => g({
+}), S = T(() => g({
   text: e(t()),
   // eslint-disable-next-line camelcase -- backend field name
   tag_text: e(t()),
@@ -76,10 +84,10 @@ const p = {
   children: e(c(S)),
   // eslint-disable-next-line camelcase -- backend field name
   select_items: e(c(S))
-})), N = k(
+})), v = k(
   t(),
   R(c(S), [])
-), P = g({
+), N = g({
   /** Block ID (matches the dictionary key and the legacy HTML element id) */
   id: e(n()),
   /** Decimal places for price display (legacy data may use string or number) */
@@ -87,9 +95,9 @@ const p = {
   /** Pinned product IDs (empty array when filter-driven) */
   productIds: e(c(r())),
   /** Whether the block requested live products at send time */
-  sendProductRequestFlag: e(o()),
+  sendProductRequestFlag: e(a()),
   /** Whether to randomize product order */
-  shuffleProducts: e(o()),
+  shuffleProducts: e(a()),
   /** Filter rules driving product selection */
   filters: e(c(r())),
   /** Currency code (e.g. 'EUR') — sometimes absent in legacy data */
@@ -109,22 +117,22 @@ const p = {
   /** Mobile-only padding (left) */
   mobileLeftPadding: e(n()),
   /** Disable responsive scaling */
-  unresponsive: e(o()),
+  unresponsive: e(a()),
   /** Layout orientation ('vertical' | 'horizontal') */
   orientation: e(t()),
   /** Whether long text is trimmed */
-  textTrimming: e(o()),
+  textTrimming: e(a()),
   /** Block type marker used by some legacy variants */
   blockType: e(t()),
   /** Size variant marker (legacy data may use string or number) */
   size: e(h([t(), n()])),
   /** Vertical responsiveness flag (legacy size=1 variants) */
-  verticalResponsiveness: e(o()),
+  verticalResponsiveness: e(a()),
   /** Legacy "Move to next line" price placement toggle (cardPricePlacement.js) */
-  isPriceMovedToNextLine: e(o()),
+  isPriceMovedToNextLine: e(a()),
   /** Legacy "Hide if same as discounted" / delete-price-for-zero-sale toggle */
-  isPriceDeletedForZeroSale: e(o())
-}), v = a({
+  isPriceDeletedForZeroSale: e(a())
+}), P = o({
   /**
    * Legacy recommendation block configs keyed by block ID.
    * Pass this when loading a template authored with the v1
@@ -132,17 +140,17 @@ const p = {
    * strategy, currency, locale, and layout data.
    */
   recommendationConfigs: e(
-    k(t(), P),
+    k(t(), N),
     {}
   )
-}), x = a({
+}), x = o({
   /** Initial HTML content */
   html: e(t(), ""),
   /** Initial CSS content */
   css: e(t(), ""),
   /** Preselected dynamic content items */
   preselectedDynamicContent: e(
-    c(E),
+    c(M),
     []
   ),
   /**
@@ -151,13 +159,13 @@ const p = {
    * (first) partner's leaf attributes into the label→token map that repairs
    * label-form placeholders (`{{ Phone Number }}`) in dropped saved modules.
    */
-  dynamicContentList: e(N, {}),
+  dynamicContentList: e(v, {}),
   /** Valid custom field attribute names from the partner's categorized fields */
   customFieldAttributes: e(c(t()), []),
   /** Selected unsubscribe page IDs */
   selectedUnsubscribePages: e(c(n()), []),
   /** Force recreate template in Stripo storage (use true when updating externally modified templates) */
-  forceRecreate: e(o(), !1),
+  forceRecreate: e(a(), !1),
   /**
    * Consumer-persisted tracking-id high-water mark (SD-141414). Used as the id floor
    * during migration so a rolled-back document never re-mints retired tracking ids.
@@ -173,13 +181,13 @@ const p = {
     0
   ),
   /** Migration-only inputs (legacy block configs) */
-  migration: e(v, {})
-}), D = a({
+  migration: e(P, {})
+}), D = o({
   /** Sender display name */
   senderName: e(t(), ""),
   /** Email subject line */
   subject: e(t(), "")
-}), O = a({
+}), O = o({
   /** Locale for the editor UI */
   locale: e(t(), "en"),
   /** Path to translations object */
@@ -192,36 +200,38 @@ const p = {
   savedModulesFolderName: e(t(), f.SAVED_MODULES),
   /** Folder name for default/prebuilt modules (used by Stripo plugin panel for path construction) */
   defaultModulesFolderName: e(t(), f.DEFAULT_MODULES)
-}), F = a({
+}), F = o({
   /** Whether to show the header bar */
-  showHeader: e(o(), !0),
+  showHeader: e(a(), !0),
   /** Custom label for back button (if shown) */
   backButtonLabel: e(t())
-}), U = a({
+}), U = o({
   /** Enable dynamic content insertion */
-  dynamicContent: e(o(), !0),
+  dynamicContent: e(a(), !0),
   /** Enable save as template functionality */
-  saveAsTemplate: e(o(), !0),
+  saveAsTemplate: e(a(), !0),
   /** Enable version history */
-  versionHistory: e(o(), !0),
+  versionHistory: e(a(), !0),
   /** Enable test message sending */
-  testMessage: e(o(), !0),
+  testMessage: e(a(), !0),
   /** Enable display conditions */
-  displayConditions: e(o(), !0),
+  displayConditions: e(a(), !0),
   /** Enable unsubscribe block */
-  unsubscribe: e(o(), !0),
+  unsubscribe: e(a(), !0),
   /** Disable modules panel in the editor */
-  modulesDisabled: e(o(), !1),
+  modulesDisabled: e(a(), !1),
   /** Enable Liquid template syntax */
-  liquidSyntax: e(o(), !1),
+  liquidSyntax: e(a(), !1),
   /** Enable autosave (3-min interval + tab-hide). User toggles on/off from the header. */
-  autosave: e(o(), !1),
+  autosave: e(a(), !1),
   /** Enable pre-save domain-allowlist validation (opt-in; Guido self-serves the block toaster) */
-  allowlistEnabled: e(o(), !1),
+  allowlistEnabled: e(a(), !1),
   /** Enable persistent link tracking-id assignment for the click heatmap (opt-in) */
-  linkTrackingIds: e(o(), !1),
-  reusableRecommendationStrategy: e(o(), !1)
-}), B = i([
+  linkTrackingIds: e(a(), !1),
+  /** Allow persisting a template that still has validation errors (drawer "Save and Continue" soft-save). Host sets false for transactional + unsubscribe. */
+  allowSaveWithErrors: e(a(), !0),
+  reusableRecommendationStrategy: e(a(), !1)
+}), w = i([
   "amp-accordion",
   "amp-carousel",
   "amp-form-controls",
@@ -235,7 +245,7 @@ const p = {
   "text-block",
   "timer-block",
   "video-block"
-]), w = i([
+]), B = i([
   "dynamic-content",
   "checkbox-block",
   "radio-button-block",
@@ -243,25 +253,25 @@ const p = {
   "unsubscribe-block",
   "coupon-block",
   "items-block"
-]), H = a({
+]), H = o({
   /** Default blocks to exclude from the editor */
   excludeDefaults: e(
-    c(B),
+    c(w),
     []
   ),
   /** Custom blocks to include in the editor */
   includeCustoms: e(
-    c(w),
+    c(B),
     []
   )
-}), d = a({
+}), d = o({
   /** Unique identifier for the rule */
   id: t(),
   /** Human-readable description */
   description: e(t()),
   /** Priority for rule ordering (lower = earlier) */
   priority: n()
-}), _ = a({
+}), _ = o({
   ...d.entries,
   type: u("replace"),
   /** String to search for */
@@ -269,8 +279,8 @@ const p = {
   /** Replacement string */
   replacement: t(),
   /** Replace all occurrences (default: false) */
-  replaceAll: e(o())
-}), j = a({
+  replaceAll: e(a())
+}), j = o({
   ...d.entries,
   type: u("regex"),
   /** Regex pattern string */
@@ -279,12 +289,12 @@ const p = {
   replacement: t(),
   /** Regex flags (e.g., 'gi') */
   flags: e(t())
-}), q = a({
+}), q = o({
   ...d.entries,
   type: u("remove"),
   /** Strings or patterns to remove */
   targets: c(t())
-}), G = a({
+}), G = o({
   ...d.entries,
   type: u("custom"),
   /** Custom processor function */
@@ -292,17 +302,17 @@ const p = {
     (s) => typeof s == "function",
     "processor must be a function"
   )
-}), V = T("type", [
+}), V = I("type", [
   _,
   j,
   q,
   G
-]), z = a({
+]), z = o({
   /** Custom compiler rules to apply */
   customRules: e(c(V), []),
   /** Skip default compiler rules */
-  ignoreDefaultRules: e(o(), !1)
-}), Z = a({
+  ignoreDefaultRules: e(a(), !1)
+}), W = o({
   /**
    * External validation handler called before save completes.
    * Return false to cancel the save operation.
@@ -313,12 +323,12 @@ const p = {
       "externalValidation must be a function"
     )
   )
-}), Q = a({
+}), K = o({
   // Required sections
   /** Identity configuration (required) */
   identity: A,
   /** Partner configuration (required) */
-  partner: M,
+  partner: E,
   // Optional sections (with defaults)
   /** Template content and presets */
   template: e(x, {}),
@@ -333,33 +343,33 @@ const p = {
   /** Compiler configuration */
   compiler: e(z, {}),
   /** Callbacks and event handlers */
-  callbacks: e(Z, {})
+  callbacks: e(W, {})
 });
 export {
   H as BlocksSchema,
-  Z as CallbacksSchema,
+  W as CallbacksSchema,
   V as CompilerRuleSchema,
   z as CompilerSchema,
-  w as CustomBlockTypeSchema,
+  B as CustomBlockTypeSchema,
   G as CustomRuleSchema,
-  B as DefaultBlockTypeSchema,
-  N as DynamicContentListSchema,
+  w as DefaultBlockTypeSchema,
+  v as DynamicContentListSchema,
   S as DynamicContentNodeSchema,
-  E as DynamicContentSchema,
+  M as DynamicContentSchema,
   O as EditorSchema,
   D as EmailHeaderSchema,
   L as FallbackFontSchema,
   U as FeaturesSchema,
-  Q as GuidoConfigSchema,
+  K as GuidoConfigSchema,
   A as IdentitySchema,
-  P as LegacyRecommendationConfigSchema,
+  N as LegacyRecommendationConfigSchema,
   p as MessageType,
-  M as PartnerSchema,
+  E as PartnerSchema,
   l as ProductType,
   j as RegexRuleSchema,
   q as RemoveRuleSchema,
   _ as ReplaceRuleSchema,
-  v as TemplateMigrationSchema,
+  P as TemplateMigrationSchema,
   x as TemplateSchema,
   F as UISchema
 };

package/dist/components/Guido.vue.js

@@ -1,20 +1,20 @@
-import o from "./Guido.vue2.js";
+import i from "./Guido.vue2.js";
 /* empty css           */
-import i from "../_virtual/_plugin-vue2_normalizer.js";
+import o from "../_virtual/_plugin-vue2_normalizer.js";
 var t = function() {
   var a = this, r = a._self._c, e = a._self._setupProxy;
-  return r("div", { ref: "wrapperRef", staticClass: "guido-editor__wrapper", class: { "guido-editor__no-header": e.noHeader } }, [r(e.HeaderWrapper, { ref: "headerWrapperRef" }), r(e.AutoSaveController), e.editorStore.isPreviewModeOpen ? r(e.PreviewContainer) : a._e(), r("div", { directives: [{ name: "show", rawName: "v-show", value: !e.previewStore.isLoaded, expression: "!previewStore.isLoaded" }], staticClass: "guido-editor__container", class: { "guido-editor__no-header": e.noHeader }, attrs: { id: "guido-editor" } }), r(e.Toaster), r(e.FilterSelectionDrawer), e.isRrsEnabled || e.hasAssignedStrategy ? r(e.AssignStrategyDrawer) : a._e(), e.isRrsEnabled || e.hasAssignedStrategy ? r(e.RemoveStrategyModal) : a._e(), r(e.SaveAsTemplateDrawer), e.isTestPartner() ? a._e() : r(e.OnboardingWrapper, { on: { "onboarding-finished": function(_) {
+  return r("div", { ref: "wrapperRef", staticClass: "guido-editor__wrapper", class: { "guido-editor__no-header": e.noHeader } }, [r(e.HeaderWrapper, { ref: "headerWrapperRef" }), r(e.AutoSaveController), e.editorStore.isPreviewModeOpen ? r(e.PreviewContainer) : a._e(), r("div", { directives: [{ name: "show", rawName: "v-show", value: !e.previewStore.isLoaded, expression: "!previewStore.isLoaded" }], staticClass: "guido-editor__container", class: { "guido-editor__no-header": e.noHeader }, attrs: { id: "guido-editor" } }), r(e.Toaster), r(e.FilterSelectionDrawer), e.isRrsEnabled || e.hasAssignedStrategy ? r(e.AssignStrategyDrawer) : a._e(), e.isRrsEnabled || e.hasAssignedStrategy ? r(e.RemoveStrategyModal) : a._e(), e.isRrsEnabled ? r(e.LegacyStrategyUpdatedModal) : a._e(), r(e.SaveAsTemplateDrawer), e.isSaveValidationEnabled ? r(e.ValidationErrorDrawer) : a._e(), e.isTestPartner() ? a._e() : r(e.OnboardingWrapper, { on: { "onboarding-finished": function(_) {
     return e.emit("onboarding:finished");
   } } }), r(e.UnsubscribeWrapper), r(e.LoadingWrapper)], 1);
-}, s = [], n = /* @__PURE__ */ i(
-  o,
+}, s = [], n = /* @__PURE__ */ o(
+  i,
   t,
   s,
   !1,
   null,
-  "050dfa52"
+  "aaa8fe47"
 );
-const f = n.exports;
+const v = n.exports;
 export {
-  f as default
+  v as default
 };