@useinsider/guido 3.19.0 → 3.20.0-beta.05ce01c

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 a, number as s, optional as e, string as t, picklist as m, pipe as i, minLength as b, custom as k, boolean as o, array as c, transform as y, unknown as r, record as g, fallback as R, literal as u, looseObject as C, variant as I, union as h, lazy as T } from "../../node_modules/valibot/dist/index.js";
 const p = {
   /** Promotional/marketing emails */
   PROMOTIONAL: 1,
@@ -14,31 +14,39 @@ const p = {
   UNSUBSCRIBE_PAGES: 97
 }, A = a({
   /** Unique identifier for the template being edited */
-  templateId: m(
+  templateId: i(
     t(),
     b(1, "templateId is required")
   ),
   /** Unique identifier for the user editing the template */
-  userId: m(
+  userId: i(
     t(),
     b(1, "userId is required")
   ),
   /** Optional variation ID for A/B testing */
-  variationId: e(t())
+  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 = a({
   /** Fallback font name (e.g., "Georgia") */
   name: t(),
   /** Fallback font family (e.g., "serif" or "sans-serif") */
   family: t()
-}), M = a({
+}), E = a({
   /** Partner/organization name (required) */
-  name: m(
+  name: i(
     t(),
     b(1, "partner.name is required")
   ),
   /** Product type identifier */
   productType: e(
-    i([
+    m([
       l.EMAIL,
       l.ARCHITECT,
       l.UNSUBSCRIBE_PAGES
@@ -47,14 +55,14 @@ const p = {
   ),
   /** Message type (promotional or transactional) */
   messageType: e(
-    i([p.PROMOTIONAL, p.TRANSACTIONAL]),
+    m([p.PROMOTIONAL, p.TRANSACTIONAL]),
     p.PROMOTIONAL
   ),
   /** Display name for the current user */
   username: e(t(), "Guido User"),
   /** Fallback font settings from partner settings — used to match backend size calculation */
   fallbackFont: e(L)
-}), E = a({
+}), M = a({
   /** Display text for the dynamic content */
   text: t(),
   /** Template variable value (e.g., {{username}}) */
@@ -68,7 +76,7 @@ const p = {
       value: t()
     })
   )
-}), S = I(() => g({
+}), S = T(() => C({
   text: e(t()),
   // eslint-disable-next-line camelcase -- backend field name
   tag_text: e(t()),
@@ -76,14 +84,14 @@ const p = {
   children: e(c(S)),
   // eslint-disable-next-line camelcase -- backend field name
   select_items: e(c(S))
-})), N = k(
+})), N = g(
   t(),
   R(c(S), [])
-), P = g({
+), P = C({
   /** Block ID (matches the dictionary key and the legacy HTML element id) */
-  id: e(n()),
+  id: e(s()),
   /** Decimal places for price display (legacy data may use string or number) */
-  decimalCount: e(h([t(), n()])),
+  decimalCount: e(h([t(), s()])),
   /** Pinned product IDs (empty array when filter-driven) */
   productIds: e(c(r())),
   /** Whether the block requested live products at send time */
@@ -103,11 +111,11 @@ const p = {
   /** Snapshot of products as rendered by the legacy block */
   recommendedProducts: e(c(r())),
   /** Number of product cards per row */
-  cardsInRow: e(n()),
+  cardsInRow: e(s()),
   /** Mobile-only padding (right) */
-  mobileRightPadding: e(n()),
+  mobileRightPadding: e(s()),
   /** Mobile-only padding (left) */
-  mobileLeftPadding: e(n()),
+  mobileLeftPadding: e(s()),
   /** Disable responsive scaling */
   unresponsive: e(o()),
   /** Layout orientation ('vertical' | 'horizontal') */
@@ -117,7 +125,7 @@ const p = {
   /** 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()])),
+  size: e(h([t(), s()])),
   /** Vertical responsiveness flag (legacy size=1 variants) */
   verticalResponsiveness: e(o()),
   /** Legacy "Move to next line" price placement toggle (cardPricePlacement.js) */
@@ -132,7 +140,7 @@ const p = {
    * strategy, currency, locale, and layout data.
    */
   recommendationConfigs: e(
-    k(t(), P),
+    g(t(), P),
     {}
   )
 }), x = a({
@@ -142,7 +150,7 @@ const p = {
   css: e(t(), ""),
   /** Preselected dynamic content items */
   preselectedDynamicContent: e(
-    c(E),
+    c(M),
     []
   ),
   /**
@@ -155,7 +163,7 @@ const p = {
   /** Valid custom field attribute names from the partner's categorized fields */
   customFieldAttributes: e(c(t()), []),
   /** Selected unsubscribe page IDs */
-  selectedUnsubscribePages: e(c(n()), []),
+  selectedUnsubscribePages: e(c(s()), []),
   /** Force recreate template in Stripo storage (use true when updating externally modified templates) */
   forceRecreate: e(o(), !1),
   /**
@@ -166,12 +174,25 @@ const p = {
    * mount. Non-numbers still fail, like every other field in this schema.
    */
   trackIdCounter: e(
-    m(
-      n(),
-      C((s) => Number.isFinite(s) ? Math.max(0, Math.floor(s)) : 0)
+    i(
+      s(),
+      y((n) => Number.isFinite(n) ? Math.max(0, Math.floor(n)) : 0)
     ),
     0
   ),
+  /**
+   * The variation's saved `recommendationCampaignUrls`, keyed by block id. A block
+   * that still names a strategy but has no entry here had it dropped by a
+   * cross-account duplicate, so Guido resets it on load (SD-151945). Omit it and
+   * that check is off, and so is any non-object value such as `null`, because a reset
+   * cannot be undone. Hosts send `[]` for an empty map.
+   */
+  recommendationCampaignUrls: e(
+    i(
+      r(),
+      y((n) => n && typeof n == "object" ? { ...n } : void 0)
+    )
+  ),
   /** Migration-only inputs (legacy block configs) */
   migration: e(v, {})
 }), D = a({
@@ -185,7 +206,7 @@ const p = {
   /** Path to translations object */
   translationsPath: e(t(), "window.trans[Object.keys(window.trans)[0]]"),
   /** Migration date for template compatibility */
-  migrationDate: e(n(), 1759696858),
+  migrationDate: e(s(), 1759696858),
   /** Email header settings */
   emailHeader: e(D, { senderName: "", subject: "" }),
   /** Folder name for user-saved modules (used by Stripo plugin panel for path construction) */
@@ -220,8 +241,10 @@ const p = {
   allowlistEnabled: e(o(), !1),
   /** Enable persistent link tracking-id assignment for the click heatmap (opt-in) */
   linkTrackingIds: e(o(), !1),
+  /** Allow persisting a template that still has validation errors (drawer "Save and Continue" soft-save). Host sets false for transactional + unsubscribe. */
+  allowSaveWithErrors: e(o(), !0),
   reusableRecommendationStrategy: e(o(), !1)
-}), B = i([
+}), w = m([
   "amp-accordion",
   "amp-carousel",
   "amp-form-controls",
@@ -235,7 +258,7 @@ const p = {
   "text-block",
   "timer-block",
   "video-block"
-]), w = i([
+]), B = m([
   "dynamic-content",
   "checkbox-block",
   "radio-button-block",
@@ -243,15 +266,15 @@ const p = {
   "unsubscribe-block",
   "coupon-block",
   "items-block"
-]), H = a({
+]), j = a({
   /** 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({
@@ -260,8 +283,8 @@ const p = {
   /** Human-readable description */
   description: e(t()),
   /** Priority for rule ordering (lower = earlier) */
-  priority: n()
-}), _ = a({
+  priority: s()
+}), H = a({
   ...d.entries,
   type: u("replace"),
   /** String to search for */
@@ -270,7 +293,7 @@ const p = {
   replacement: t(),
   /** Replace all occurrences (default: false) */
   replaceAll: e(o())
-}), j = a({
+}), _ = a({
   ...d.entries,
   type: u("regex"),
   /** Regex pattern string */
@@ -288,13 +311,13 @@ const p = {
   ...d.entries,
   type: u("custom"),
   /** Custom processor function */
-  processor: y(
-    (s) => typeof s == "function",
+  processor: k(
+    (n) => typeof n == "function",
     "processor must be a function"
   )
-}), V = T("type", [
+}), V = I("type", [
+  H,
   _,
-  j,
   q,
   G
 ]), z = a({
@@ -302,23 +325,23 @@ const p = {
   customRules: e(c(V), []),
   /** Skip default compiler rules */
   ignoreDefaultRules: e(o(), !1)
-}), Z = a({
+}), W = a({
   /**
    * External validation handler called before save completes.
    * Return false to cancel the save operation.
    */
   externalValidation: e(
-    y(
-      (s) => typeof s == "function",
+    k(
+      (n) => typeof n == "function",
       "externalValidation must be a function"
     )
   )
-}), Q = a({
+}), K = a({
   // 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, {}),
@@ -329,36 +352,36 @@ const p = {
   /** Feature toggles */
   features: e(U, {}),
   /** Block configuration */
-  blocks: e(H, {}),
+  blocks: e(j, {}),
   /** Compiler configuration */
   compiler: e(z, {}),
   /** Callbacks and event handlers */
-  callbacks: e(Z, {})
+  callbacks: e(W, {})
 });
 export {
-  H as BlocksSchema,
-  Z as CallbacksSchema,
+  j as BlocksSchema,
+  W as CallbacksSchema,
   V as CompilerRuleSchema,
   z as CompilerSchema,
-  w as CustomBlockTypeSchema,
+  B as CustomBlockTypeSchema,
   G as CustomRuleSchema,
-  B as DefaultBlockTypeSchema,
+  w as DefaultBlockTypeSchema,
   N 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,
   p as MessageType,
-  M as PartnerSchema,
+  E as PartnerSchema,
   l as ProductType,
-  j as RegexRuleSchema,
+  _ as RegexRuleSchema,
   q as RemoveRuleSchema,
-  _ as ReplaceRuleSchema,
+  H as ReplaceRuleSchema,
   v as TemplateMigrationSchema,
   x as TemplateSchema,
   F as UISchema

package/dist/components/Guido.vue.js

@@ -3,7 +3,7 @@ import o from "./Guido.vue2.js";
 import i 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.AuthErrorModal), 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(
@@ -12,9 +12,9 @@ var t = function() {
   s,
   !1,
   null,
-  "050dfa52"
+  "d0a8825a"
 );
-const f = n.exports;
+const v = n.exports;
 export {
-  f as default
+  v as default
 };