@guidelytech/sdk-core 0.14.0 → 0.16.0

package/README.md

@@ -81,6 +81,7 @@ event, never thrown into the host application.
 | `completeChecklistTask(idOrKey, taskId)` | Manual completion; syncs to `/sdk/checklists/:id/progress`. |
 | `openChecklist(idOrKey)` / `closeChecklist(idOrKey)` | Show/hide the checklist panel (re-renders a dismissed checklist). |
 | `openResourceCenter()` / `closeResourceCenter()` | Toggle the resource center panel. |
+| `openArticle(articleId)` | Open one help article (Scout's Help tab when the messenger is on). Links to `#guidely-article:<id>` anywhere on the page, including guide bodies, do this. |
 | `refresh()` | Re-fetch config now. |
 | `on(event, cb): () => void` / `off(event, cb)` | Subscribe to events (below). |
 | `getContext()` | The `TargetingContext` used for rule evaluation (debugging). |

package/dist/index.cjs

@@ -1735,7 +1735,7 @@ function buildMessengerVisitor(input) {
       key: g.key,
       title: step.title || g.name,
       body: plainText(step.body ?? ""),
-      imageUrl: step.imageUrl || null,
+      imageUrl: step.imageUrl || (0, import_runtime15.videoThumbnailUrl)(step.videoUrl) || null,
       publishedAt: g.publishedAt,
       // Read once opened in the News tab, or once the announcement itself was shown.
       unread: !seen.has(g.id) && !(state.guides[g.id]?.impressions ?? 0)
@@ -2118,7 +2118,7 @@ var loadRecorder = async () => (await import("./recorder.cjs")).recorder;
 
 // src/client.ts
 var SDK_NAME = "@guidelytech/sdk-core";
-var SDK_VERSION = "0.14.0";
+var SDK_VERSION = "0.16.0";
 var DEFAULT_API_URL = "https://api.guidely.app";
 var PAGE_SCOPED = /* @__PURE__ */ new Set(["page_load", "url_match", "element_click", "element_visible", "delay"]);
 var DAY_MS = 24 * 60 * 60 * 1e3;
@@ -2384,6 +2384,15 @@ var GuidelyClient = class _GuidelyClient {
     const onClick = (e) => this.handleDocumentClick(e);
     doc.addEventListener("click", onClick, true);
     this.cleanups.push(() => doc.removeEventListener("click", onClick, true));
+    const onArticleLink = (e) => {
+      if (e.defaultPrevented) return;
+      const articleId = (0, import_runtime18.articleIdFromHref)((0, import_guide_runtime5.composedTarget)(e)?.closest?.("a[href]")?.getAttribute("href"));
+      if (!articleId) return;
+      e.preventDefault();
+      this.openArticle(articleId);
+    };
+    doc.addEventListener("click", onArticleLink);
+    this.cleanups.push(() => doc.removeEventListener("click", onArticleLink));
     const onVisibility = () => {
       const hidden = doc.visibilityState === "hidden";
       this.pageTracker.setHidden(hidden);
@@ -3357,6 +3366,7 @@ var GuidelyClient = class _GuidelyClient {
         if (action === "start_guide" && value) this.setTimer(() => this.startGuide(value), 0);
         else if (action === "event" && value) this.track(value);
         else if (action === "open_resource_center") this.openResourceCenter();
+        else if (action === "open_article" && value) this.openArticle(value);
       },
       onEnd: (reason) => {
         if (exclusive) {
@@ -3767,6 +3777,19 @@ var GuidelyClient = class _GuidelyClient {
     if (!this.resourceCenter) this.renderPersistentWidgets();
     this.resourceCenter?.open();
   }
+  /**
+   * Opens one help article: in Scout's Help tab when the messenger is on, otherwise in the resource
+   * center. Help-article links in guides (`#guidely-article:<id>`) call this.
+   */
+  openArticle(articleId) {
+    if (this.config?.messenger?.enabled) {
+      void this.loadMessenger().then((m) => m?.openArticle(articleId));
+      return;
+    }
+    if (!this.resourceCenter) this.renderPersistentWidgets();
+    if (this.resourceCenter) this.resourceCenter.openArticle(articleId);
+    else this.log("openArticle: the resource center is not enabled or published for this environment");
+  }
   closeResourceCenter() {
     if (this.messenger) return this.closeMessenger();
     this.resourceCenter?.close();