@stripchatdev/ext-helper 0.3.0 → 0.3.2

package/dist/ext-helper.js

@@ -1,8 +1,8 @@
 const O = (e) => !!e && typeof e == "object" && "protocol" in e && e.protocol === "platform_pubsub" && "version" in e && e.version === "1.0", I = (e) => e, P = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
-var f;
+var m;
 (function(e) {
   e.Base32IncorrectEncoding = "B32_ENC_INVALID", e.DecodeTimeInvalidCharacter = "DEC_TIME_CHAR", e.DecodeTimeValueMalformed = "DEC_TIME_MALFORMED", e.EncodeTimeNegative = "ENC_TIME_NEG", e.EncodeTimeSizeExceeded = "ENC_TIME_SIZE_EXCEED", e.EncodeTimeValueMalformed = "ENC_TIME_MALFORMED", e.PRNGDetectFailure = "PRNG_DETECT", e.ULIDInvalid = "ULID_INVALID", e.Unexpected = "UNEXPECTED", e.UUIDInvalid = "UUID_INVALID";
-})(f || (f = {}));
+})(m || (m = {}));
 class y extends Error {
   constructor(t, r) {
     super(`${r} (${t})`), this.name = "ULIDError", this.code = t;
@@ -13,7 +13,7 @@ function A(e) {
   return P.charAt(t);
 }
 function x(e) {
-  const t = C(), r = t && (t.crypto || t.msCrypto) || null;
+  const t = D(), r = t && (t.crypto || t.msCrypto) || null;
   if (typeof (r == null ? void 0 : r.getRandomValues) == "function")
     return () => {
       const n = new Uint8Array(1);
@@ -21,12 +21,12 @@ function x(e) {
     };
   if (typeof (r == null ? void 0 : r.randomBytes) == "function")
     return () => r.randomBytes(1).readUInt8() / 255;
-  throw new y(f.PRNGDetectFailure, "Failed to find a reliable PRNG");
+  throw new y(m.PRNGDetectFailure, "Failed to find a reliable PRNG");
 }
-function C() {
+function D() {
   return j() ? self : typeof window < "u" ? window : typeof global < "u" ? global : typeof globalThis < "u" ? globalThis : null;
 }
-function D(e, t) {
+function C(e, t) {
   let r = "";
   for (; e > 0; e--)
     r = A(t) + r;
@@ -34,13 +34,13 @@ function D(e, t) {
 }
 function F(e, t = 10) {
   if (isNaN(e))
-    throw new y(f.EncodeTimeValueMalformed, `Time must be a number: ${e}`);
+    throw new y(m.EncodeTimeValueMalformed, `Time must be a number: ${e}`);
   if (e > 281474976710655)
-    throw new y(f.EncodeTimeSizeExceeded, `Cannot encode a time larger than ${281474976710655}: ${e}`);
+    throw new y(m.EncodeTimeSizeExceeded, `Cannot encode a time larger than ${281474976710655}: ${e}`);
   if (e < 0)
-    throw new y(f.EncodeTimeNegative, `Time must be positive: ${e}`);
+    throw new y(m.EncodeTimeNegative, `Time must be positive: ${e}`);
   if (Number.isInteger(e) === !1)
-    throw new y(f.EncodeTimeValueMalformed, `Time must be an integer: ${e}`);
+    throw new y(m.EncodeTimeValueMalformed, `Time must be an integer: ${e}`);
   let r, n = "";
   for (let s = t; s > 0; s--)
     r = e % 32, n = P.charAt(r) + n, e = (e - r) / 32;
@@ -51,7 +51,7 @@ function j() {
 }
 function E(e, t) {
   const r = t || x(), n = !e || isNaN(e) ? Date.now() : e;
-  return F(n, 10) + D(16, r);
+  return F(n, 10) + C(16, r);
 }
 const G = ({ seq: e, uniqId: t }) => (r) => ({
   ...{
@@ -69,17 +69,17 @@ const G = ({ seq: e, uniqId: t }) => (r) => ({
 class z {
   constructor(t) {
     this.eventHandlerMap = /* @__PURE__ */ new Map(), this.transportMessageHandler = (s) => {
-      const { data: o, senderId: i } = s;
+      const { data: o, senderId: a } = s;
       if (O(o)) {
         if (o.type === "event") {
-          const { eventName: a } = o, c = this.eventHandlerMap.get(a);
+          const { eventName: i } = o, c = this.eventHandlerMap.get(i);
           if (!c)
             return;
-          c.forEach((h) => {
+          c.forEach((l) => {
             try {
-              h(o.data, i);
-            } catch (m) {
-              console.error("[PubSubSubscriber] transportMessageHandler: failed to handle income message", m);
+              l(o.data, a);
+            } catch (f) {
+              console.error("[PubSubSubscriber] transportMessageHandler: failed to handle income message", f);
             }
           });
           return;
@@ -170,21 +170,21 @@ class Z {
       const { data: o } = s;
       if (U(o)) {
         if (o.type === "response" && o.status === "ok") {
-          const i = this.pendingEntryMap.get(o.requestId);
-          if (!i) {
+          const a = this.pendingEntryMap.get(o.requestId);
+          if (!a) {
             console.error("[RpcClient] transportMessageHandler: got success response without pending request", o);
             return;
           }
-          this.pendingEntryMap.delete(o.requestId), i.resolve(o.result);
+          this.pendingEntryMap.delete(o.requestId), a.resolve(o.result);
           return;
         }
         if (o.type === "response" && o.status === "error") {
-          const i = this.pendingEntryMap.get(o.requestId);
-          if (!i) {
+          const a = this.pendingEntryMap.get(o.requestId);
+          if (!a) {
             console.error("[RpcClient] transportMessageHandler: got error response without pending request", o);
             return;
           }
-          this.pendingEntryMap.delete(o.requestId), i.reject(new $(o.error));
+          this.pendingEntryMap.delete(o.requestId), a.reject(new $(o.error));
           return;
         }
         console.error("[RpcClient] transportMessageHandler: invalid message schema", o);
@@ -198,14 +198,14 @@ class Z {
       type: "request",
       method: t,
       params: r
-    }), s = new Promise((o, i) => {
+    }), s = new Promise((o, a) => {
       this.pendingEntryMap.set(n.requestId, {
         method: t,
-        resolve: (a) => {
-          o(a);
+        resolve: (i) => {
+          o(i);
         },
-        reject: (a) => {
-          i(a);
+        reject: (i) => {
+          a(i);
         }
       });
     });
@@ -213,8 +213,8 @@ class Z {
       this.transport.send(this.serverId, n);
     } catch (o) {
       console.error("[RpcClient] makeRequest: failed to send rpc message", o);
-      const i = this.pendingEntryMap.get(n.requestId);
-      i && (this.pendingEntryMap.delete(n.requestId), i.reject(o));
+      const a = this.pendingEntryMap.get(n.requestId);
+      a && (this.pendingEntryMap.delete(n.requestId), a.reject(o));
     }
     return s;
   }
@@ -230,14 +230,14 @@ const Q = (e) => !!e && typeof e == "object" && "protocol" in e && e.protocol ==
 class ee {
   constructor(t) {
     this.peers = /* @__PURE__ */ new Map(), this.handlers = /* @__PURE__ */ new Set(), this.onMessage = (s) => {
-      const o = (i) => {
-        const { data: a, origin: c, source: h } = i;
-        if (!h || !Q(a))
+      const o = (a) => {
+        const { data: i, origin: c, source: l } = a;
+        if (!l || !Q(i))
           return;
-        const { recipientId: m } = a;
-        if (!(m !== this.transportId || !this.findPeer(h, c)))
+        const { recipientId: f } = i;
+        if (!(f !== this.transportId || !this.findPeer(l, c)))
           try {
-            s(a);
+            s(i);
           } catch (w) {
             console.error("[PostMessageTransport] onMessage: failed to call cb on message", w);
           }
@@ -329,10 +329,10 @@ const g = {
       };
     }
   return g;
-}, _ = (e) => {
+}, L = (e) => {
   const t = [];
   if (e instanceof Error)
-    t.push(e.message), "cause" in e && t.push(_(e.cause));
+    t.push(e.message), "cause" in e && t.push(L(e.cause));
   else
     try {
       const r = JSON.stringify(e);
@@ -365,28 +365,28 @@ const g = {
   /networkError when attempting to fetch resource/ig,
   /load failed/ig
 ], re = (e) => te.some((t) => (t.lastIndex = 0, t.test(e))), ne = (e) => {
-  const t = _(e.error), r = typeof e.data == "object" && "message" in e.data && typeof e.data.message == "string" ? e.data.message : "";
+  const t = L(e.error), r = typeof e.data == "object" && "message" in e.data && typeof e.data.message == "string" ? e.data.message : "";
   return [t, r].filter((n) => !!n).join(":");
 }, se = (e) => e.data && typeof e.data == "object" && "filename" in e.data ? String(e.data.filename ?? "") : "", oe = (e) => {
   const t = ne(e), r = se(e);
   return r && /^(chrome|moz|safari)-extension:\/\//.test(r) ? !0 : !!t && re(t);
-}, ie = "get", ae = (e, t) => {
+}, ae = "get", ie = (e, t) => {
   var s;
   let r, n;
   return e instanceof Request ? (r = e.url, n = e.method) : e instanceof URL ? r = e.toString() : r = e, {
-    method: n || ((s = t == null ? void 0 : t.method) == null ? void 0 : s.toString()) || ie,
+    method: n || ((s = t == null ? void 0 : t.method) == null ? void 0 : s.toString()) || ae,
     url: r
   };
 }, ce = (e, t, r) => ({
   statusCode: r.status,
-  ...ae(e, t)
+  ...ie(e, t)
 }), ue = (e) => {
   const t = window.fetch;
   Object.defineProperty(window, "fetch", {
     value: async (n, s) => {
       try {
-        const o = new Error("synthetic error"), i = await t(n, s), a = i.clone(), c = ce(n, s, a);
-        if (i.status >= 500) {
+        const o = new Error("synthetic error"), a = await t(n, s), i = a.clone(), c = ce(n, s, i);
+        if (a.status >= 500) {
           const d = new Error("fetch response error");
           d.stack = o.stack, e.report({
             kind: "fetchResponseError",
@@ -396,12 +396,12 @@ const g = {
           });
         }
         const {
-          arrayBuffer: h,
-          blob: m,
+          arrayBuffer: l,
+          blob: f,
           json: M,
           text: w
-        } = i;
-        return i.json = async function() {
+        } = a;
+        return a.json = async function() {
           try {
             return await M.call(this);
           } catch (d) {
@@ -415,7 +415,7 @@ const g = {
               }
             }), d;
           }
-        }, i.text = async function() {
+        }, a.text = async function() {
           try {
             return await w.call(this);
           } catch (d) {
@@ -429,9 +429,9 @@ const g = {
               }
             }), d;
           }
-        }, i.blob = async function() {
+        }, a.blob = async function() {
           try {
-            return await m.call(this);
+            return await f.call(this);
           } catch (d) {
             throw e.report({
               type: "network",
@@ -443,9 +443,9 @@ const g = {
               }
             }), d;
           }
-        }, i.arrayBuffer = async function() {
+        }, a.arrayBuffer = async function() {
           try {
-            return await h.call(this);
+            return await l.call(this);
           } catch (d) {
             throw e.report({
               type: "network",
@@ -457,7 +457,7 @@ const g = {
               }
             }), d;
           }
-        }, i;
+        }, a;
       } catch (o) {
         throw o instanceof Error && o.name === "AbortError", o;
       }
@@ -485,23 +485,23 @@ const g = {
       }
     });
   });
-}, L = Symbol("patchedXHLHttpRequest"), p = Symbol("requestInfo"), le = (e) => ({
+}, _ = Symbol("patchedXHLHttpRequest"), h = Symbol("requestInfo"), le = (e) => ({
   statusCode: e.status,
-  ...e[p]
-}), pe = (e) => (e[p] || (e[p] = {}), e[p]), he = (e) => {
-  e[L] = !0;
-}, fe = (e) => e[L] === !0, me = (e) => {
+  ...e[h]
+}), pe = (e) => (e[h] || (e[h] = {}), e[h]), he = (e) => {
+  e[_] = !0;
+}, fe = (e) => e[_] === !0, me = (e) => {
   const t = XMLHttpRequest.prototype.send, r = XMLHttpRequest.prototype.open, n = function(...o) {
-    const [i, a] = o;
-    this[p] = {
-      method: i,
-      url: typeof a == "string" ? a : a.toString()
+    const [a, i] = o;
+    this[h] = {
+      method: a,
+      url: typeof i == "string" ? i : i.toString()
     }, fe(this) || (he(this), this.addEventListener("error", () => {
       const c = new Error("XMLHttpRequest network error");
       e.report({
         type: "network",
         kind: "xmlHttpRequestError",
-        data: this[p],
+        data: this[h],
         error: c
       });
     }), this.addEventListener("timeout", () => {
@@ -509,7 +509,7 @@ const g = {
       e.report({
         type: "network",
         kind: "xmlHttpRequestTimeoutError",
-        data: this[p],
+        data: this[h],
         error: c
       });
     }), this.addEventListener("load", () => {
@@ -530,20 +530,20 @@ const g = {
         type: "network",
         kind: "xmlHttpRequestOpenError",
         error: c,
-        data: this[p]
+        data: this[h]
       }), c;
     }
   }, s = function(o) {
     try {
-      const i = pe(this), a = new Error("XMLHttpRequest request initiator");
-      i.requestStack = a.stack, t.call(this, o);
-    } catch (i) {
+      const a = pe(this), i = new Error("XMLHttpRequest request initiator");
+      a.requestStack = i.stack, t.call(this, o);
+    } catch (a) {
       throw e.report({
         type: "network",
         kind: "xmlHttpRequestSendError",
-        error: i,
-        data: this[p]
-      }), i;
+        error: a,
+        data: this[h]
+      }), a;
     }
   };
   Object.defineProperty(XMLHttpRequest.prototype, "open", {
@@ -581,25 +581,26 @@ class ye {
   constructor(t) {
     const {
       frameId: r,
-      serverId: n,
-      serverOrigin: s,
-      serverSource: o,
+      lang: n,
+      serverId: s,
+      serverOrigin: o,
+      serverSource: a,
       theme: i
-    } = t, a = {
-      id: n,
-      origin: s,
-      source: o
-    }, c = new ee({
+    } = t, c = {
+      id: s,
+      origin: o,
+      source: a
+    }, l = new ee({
       transportId: r
     });
-    c.addPeer(a), this.rpcClient = new Z({
-      transport: c,
-      serverId: n
+    l.addPeer(c), this.rpcClient = new Z({
+      transport: l,
+      serverId: s
     }), this.subscriber = new z({
-      transport: c,
-      brokerId: a.id
-    }), document.documentElement.dataset.theme = i, this.crashReporter = new ge((h) => {
-      this.makeRequest("v1.system.report.crash", h);
+      transport: l,
+      brokerId: c.id
+    }), document.documentElement.dataset.theme = i, document.documentElement.lang = n, this.crashReporter = new ge((f) => {
+      this.makeRequest("v1.system.report.crash", f);
     });
   }
   makeRequest(t, r) {
@@ -614,20 +615,20 @@ class ye {
   bootstrap() {
     let t = { height: 0, width: 0 };
     const r = () => {
-      const a = document.body;
+      const i = document.body;
       return Math.max(
-        a.offsetHeight,
-        a.scrollHeight
+        i.offsetHeight,
+        i.scrollHeight
       );
     }, n = () => {
-      const a = document.body;
+      const i = document.body;
       return Math.max(
-        a.offsetWidth,
-        a.scrollWidth
+        i.offsetWidth,
+        i.scrollWidth
       );
     }, s = () => {
-      const a = n(), c = r();
-      (t.height !== c || t.width !== a) && (t = { height: c, width: a }, this.makeRequest("v1.system.resize.notify", { height: c, width: a }));
+      const i = n(), c = r();
+      (t.height !== c || t.width !== i) && (t = { height: c, width: i }, this.makeRequest("v1.system.resize.notify", { height: c, width: i }));
     };
     s(), new ResizeObserver(s).observe(document.body), new MutationObserver(s).observe(document.body, {
       childList: !0,
@@ -664,7 +665,7 @@ function Se(e) {
   const r = e instanceof SubmitEvent ? e.submitter : null, n = (r == null ? void 0 : r.getAttribute("formtarget")) || t.getAttribute("target") || ((s = document.querySelector("base[target]")) == null ? void 0 : s.getAttribute("target")) || "_self";
   R(n) && (e.preventDefault(), e.stopImmediatePropagation());
 }
-const l = () => {
+const p = () => {
 }, u = (e, t, r) => {
   const n = e;
   if (!n || typeof n[t] != "function")
@@ -681,34 +682,36 @@ const l = () => {
     } catch {
     }
 }, Ne = () => {
-  u(Window.prototype, "open", () => null), u(window, "open", () => null), u(Element.prototype, "scrollIntoView", l), u(
+  u(Window.prototype, "open", () => null), u(window, "open", () => null), u(Element.prototype, "scrollIntoView", p), u(
     Element.prototype,
     "scrollIntoViewIfNeeded",
-    l
-  ), u(HTMLElement.prototype, "focus", T), u(SVGElement.prototype, "focus", T), u(History.prototype, "back", l), u(History.prototype, "forward", l), u(History.prototype, "go", l), u(History.prototype, "pushState", l), u(History.prototype, "replaceState", l), u(
+    p
+  ), u(HTMLElement.prototype, "focus", T), u(SVGElement.prototype, "focus", T), u(History.prototype, "back", p), u(History.prototype, "forward", p), u(History.prototype, "go", p), u(History.prototype, "pushState", p), u(History.prototype, "replaceState", p), u(
     HTMLVideoElement.prototype,
     "requestPictureInPicture",
     () => Promise.resolve({})
-  ), u(HTMLFormElement.prototype, "submit", Ie), u(HTMLFormElement.prototype, "requestSubmit", ve), typeof Location < "u" && (u(Location.prototype, "assign", l), u(Location.prototype, "replace", l), u(Location.prototype, "reload", l)), document.addEventListener("submit", Se, !0);
-}, H = (e) => typeof e == "object" && e !== null && !Array.isArray(e), Te = (e) => H(e) ? typeof e.code == "string" && typeof e.message == "string" && (e.details === void 0 || H(e.details)) : !1;
+  ), u(HTMLFormElement.prototype, "submit", Ie), u(HTMLFormElement.prototype, "requestSubmit", ve), typeof Location < "u" && (u(Location.prototype, "assign", p), u(Location.prototype, "replace", p), u(Location.prototype, "reload", p)), document.addEventListener("submit", Se, !0);
+}, H = (e) => typeof e == "object" && e !== null && !Array.isArray(e), He = (e) => H(e) ? typeof e.code == "string" && typeof e.message == "string" && (e.details === void 0 || H(e.details)) : !1;
 let k = !1;
+const Te = "en";
 typeof window < "u" && typeof document < "u" && Ne();
-const He = () => {
+const ke = () => {
   if (k)
     throw new Error("ext helper already created, only one instance is allowed");
-  const e = new URL(window.location.href), t = e.searchParams.get("origin") || "", r = e.searchParams.get("theme") || "dark", n = e.searchParams.get("frameId");
-  if (!n)
+  const e = new URL(window.location.href), t = e.searchParams.get("origin") || "", r = e.searchParams.get("theme") || "dark", n = e.searchParams.get("lang") || Te, s = e.searchParams.get("frameId");
+  if (!s)
     throw new Error("failed to create ext helper, frameId is empty");
-  const s = new ye({
+  const o = new ye({
     serverId: "server",
     serverOrigin: t || window.parent.origin,
     serverSource: window.parent,
-    frameId: n,
-    theme: r
+    frameId: s,
+    theme: r,
+    lang: n
   });
-  return s.bootstrap(), k = !0, s;
+  return o.bootstrap(), k = !0, o;
 };
 export {
-  He as createExtHelper,
-  Te as isExtensionError
+  ke as createExtHelper,
+  He as isExtensionError
 };

package/dist/helpers/index.d.ts

@@ -119,6 +119,8 @@ export declare type TSlotStateSnapshot<State extends object> = {
     state: State | null;
 };
 
+declare type TTheme = 'light' | 'dark';
+
 declare type TTransportPeer = {
     id: string;
 };
@@ -143,6 +145,8 @@ declare type TV1ActionResult = {
     code: number;
 };
 
+declare type TV1AnalyticsTrackParams = TV1UiInteractionTrackParams;
+
 declare type TV1ChatEvents = {
     /** Triggered on every new message in a chat */
     'v1.chat.message.received': {
@@ -192,6 +196,20 @@ declare type TV1ChatMethods = {
         };
         result: null;
     };
+    /**
+     * Send a rich message to the chat with customizable colors.
+     *
+     * The message is sent locally on behalf of the extension. It is not sent to the server or broadcast — each user sees it only in their own local chat feed.
+     *
+     * Because the message is local, it is **not persisted**: it disappears from chat history when the page is reloaded.
+     *
+     * Required permission:
+     * - `richMessage`
+     */
+    'v1.chat.richMessage.send': {
+        params: TV1RichMessage;
+        result: null;
+    };
     /** Use this method to send a message in the chat as a bot or model.
      *  The message is sent locally to each user and looks like a normal chat message. The message is **not persisted** and will disappear from the chat after the page is reloaded.
      * */
@@ -324,6 +342,19 @@ declare type TV1ExtMethods = {
         params: null;
         result: TV1ExtContext;
     };
+    /**
+     * Returns the tag from which the user navigated to the model.
+     * `tag` is `null` when the source tag is unknown.
+     *
+     * Required permission:
+     * - `modelTag`
+     */
+    'v1.ext.modelTag.get': {
+        params: null;
+        result: {
+            tag: TV1ExtModelTag | null;
+        };
+    };
     'v1.ext.movableOverlay.update': {
         params: {
             message?: string;
@@ -340,6 +371,8 @@ declare type TV1ExtMethods = {
     /** Opens Stripchat sign-up dialog for anonymous users. Use this when your extension requires a registered account to function */
     'v1.ext.signup.open': {
         params: {
+            /** Optional source string to identify the origin of the sign-up request. Internal use only */
+            source?: string;
             type: 'user';
         };
         result: null;
@@ -418,6 +451,21 @@ declare type TV1ExtModel = {
     username: string;
 };
 
+/**
+ * Tag from which the user navigated to the model.
+ *
+ * Required permission:
+ * - `modelTag`
+ */
+declare type TV1ExtModelTag = {
+    /** Tag identifier, for example `autoTagNew` */
+    id: string;
+    /** Primary tag the tag belongs to */
+    primaryTagId: 'girls' | 'men' | 'trans' | 'couples';
+    /** Tag URL path, for example `girls/new` */
+    url: string;
+};
+
 declare type TV1ExtSettings = unknown;
 
 declare type TV1ExtUser = TV1ExtGuestUser | TV1ExtLoggedInUser;
@@ -593,6 +641,52 @@ declare type TV1PrivateMethods = {
     };
 };
 
+declare type TV1RichMessage = {
+    /** The main action appearance. It opens the extension tab on click. If omitted, the default action is a link. */
+    action?: {
+        text?: string;
+        type: 'link' | 'button';
+    };
+    /** One of the predefined extension icons. If omitted, the icon from the manifest is used. */
+    icon?: 'sex-toy-1' | 'sex-toy-2' | 'spicy-pepper';
+    /**
+     * Rich message subtitle.
+     *
+     * Supports inline markup tags:
+     * - `{#primary}...{/primary}` — uses the primary text color.
+     * - `{#secondary}...{/secondary}` — uses the secondary text color.
+     * - `{#accent}...{/accent}` — highlights text with an accent color.
+     * - `{#bold}...{/bold}` — renders bold text.
+     *
+     * Example: `'won {#accent}Alice{/accent} in'`
+     */
+    subtitle: string;
+    /** Optional custom theme. If omitted, the default theme is used. */
+    theme?: {
+        [Property in TTheme]?: TV1RichMessageTheme;
+    };
+    /**
+     * Rich message title.
+     *
+     * Supports inline markup tags:
+     * - `{#primary}...{/primary}` — uses the primary text color.
+     * - `{#secondary}...{/secondary}` — uses the secondary text color.
+     * - `{#accent}...{/accent}` — highlights text with an accent color.
+     * - `{#bold}...{/bold}` — renders bold text.
+     *
+     * Example: `'won {#accent}Alice{/accent} in'`
+     */
+    title: string;
+};
+
+declare type TV1RichMessageTheme = {
+    /** Rich message background color. Use a hex color. */
+    background: string;
+    buttonText: 'white' | 'dark';
+    /** Main accent color of the rich message, used for the sidebar, highlights, links, and buttons. Use a hex color. */
+    main: string;
+};
+
 declare type TV1SerializedError = {
     cause?: TV1SerializedError;
     message: string;
@@ -942,6 +1036,10 @@ declare type TV1StorageMethods = {
 };
 
 declare type TV1SystemMethods = {
+    'v1.system.analytics.track': {
+        params: TV1AnalyticsTrackParams;
+        result: null;
+    };
     'v1.system.report.crash': {
         params: {
             data?: Record<string, unknown>;
@@ -1081,6 +1179,17 @@ declare type TV1TopUserEntry = {
 
 declare type TV1TopWindow = 'TOP_1D' | 'TOP_7D' | 'TOP_30D' | 'TOP_UNSPECIFIED';
 
+declare type TV1UiInteractionTrackParams = {
+    data: {
+        elementId: string;
+        elementType: 'banner' | 'button' | 'tile' | 'popup' | 'extensionButton';
+        interactionType: 'view' | 'click' | 'close' | 'dismiss';
+        optionSelected?: string;
+        pageSection?: string;
+    };
+    type: 'uiInteraction';
+};
+
 /**
  * User activity league. Ordered from lowest to highest activity rank:
  * - `grey` — new or low-activity users (level 1–9)

package/dist/helpers/react.d.ts

@@ -53,6 +53,8 @@ declare type TMethods = TV1Methods;
  */
 declare type TMovableOverlayStatus = 'active' | 'inactive' | 'connecting' | 'error';
 
+declare type TTheme = 'light' | 'dark';
+
 declare type TTransportPeer = {
     id: string;
 };
@@ -77,6 +79,8 @@ declare type TV1ActionResult = {
     code: number;
 };
 
+declare type TV1AnalyticsTrackParams = TV1UiInteractionTrackParams;
+
 declare type TV1ChatEvents = {
     /** Triggered on every new message in a chat */
     'v1.chat.message.received': {
@@ -126,6 +130,20 @@ declare type TV1ChatMethods = {
         };
         result: null;
     };
+    /**
+     * Send a rich message to the chat with customizable colors.
+     *
+     * The message is sent locally on behalf of the extension. It is not sent to the server or broadcast — each user sees it only in their own local chat feed.
+     *
+     * Because the message is local, it is **not persisted**: it disappears from chat history when the page is reloaded.
+     *
+     * Required permission:
+     * - `richMessage`
+     */
+    'v1.chat.richMessage.send': {
+        params: TV1RichMessage;
+        result: null;
+    };
     /** Use this method to send a message in the chat as a bot or model.
      *  The message is sent locally to each user and looks like a normal chat message. The message is **not persisted** and will disappear from the chat after the page is reloaded.
      * */
@@ -258,6 +276,19 @@ declare type TV1ExtMethods = {
         params: null;
         result: TV1ExtContext;
     };
+    /**
+     * Returns the tag from which the user navigated to the model.
+     * `tag` is `null` when the source tag is unknown.
+     *
+     * Required permission:
+     * - `modelTag`
+     */
+    'v1.ext.modelTag.get': {
+        params: null;
+        result: {
+            tag: TV1ExtModelTag | null;
+        };
+    };
     'v1.ext.movableOverlay.update': {
         params: {
             message?: string;
@@ -274,6 +305,8 @@ declare type TV1ExtMethods = {
     /** Opens Stripchat sign-up dialog for anonymous users. Use this when your extension requires a registered account to function */
     'v1.ext.signup.open': {
         params: {
+            /** Optional source string to identify the origin of the sign-up request. Internal use only */
+            source?: string;
             type: 'user';
         };
         result: null;
@@ -352,6 +385,21 @@ declare type TV1ExtModel = {
     username: string;
 };
 
+/**
+ * Tag from which the user navigated to the model.
+ *
+ * Required permission:
+ * - `modelTag`
+ */
+declare type TV1ExtModelTag = {
+    /** Tag identifier, for example `autoTagNew` */
+    id: string;
+    /** Primary tag the tag belongs to */
+    primaryTagId: 'girls' | 'men' | 'trans' | 'couples';
+    /** Tag URL path, for example `girls/new` */
+    url: string;
+};
+
 declare type TV1ExtSettings = unknown;
 
 declare type TV1ExtUser = TV1ExtGuestUser | TV1ExtLoggedInUser;
@@ -527,6 +575,52 @@ declare type TV1PrivateMethods = {
     };
 };
 
+declare type TV1RichMessage = {
+    /** The main action appearance. It opens the extension tab on click. If omitted, the default action is a link. */
+    action?: {
+        text?: string;
+        type: 'link' | 'button';
+    };
+    /** One of the predefined extension icons. If omitted, the icon from the manifest is used. */
+    icon?: 'sex-toy-1' | 'sex-toy-2' | 'spicy-pepper';
+    /**
+     * Rich message subtitle.
+     *
+     * Supports inline markup tags:
+     * - `{#primary}...{/primary}` — uses the primary text color.
+     * - `{#secondary}...{/secondary}` — uses the secondary text color.
+     * - `{#accent}...{/accent}` — highlights text with an accent color.
+     * - `{#bold}...{/bold}` — renders bold text.
+     *
+     * Example: `'won {#accent}Alice{/accent} in'`
+     */
+    subtitle: string;
+    /** Optional custom theme. If omitted, the default theme is used. */
+    theme?: {
+        [Property in TTheme]?: TV1RichMessageTheme;
+    };
+    /**
+     * Rich message title.
+     *
+     * Supports inline markup tags:
+     * - `{#primary}...{/primary}` — uses the primary text color.
+     * - `{#secondary}...{/secondary}` — uses the secondary text color.
+     * - `{#accent}...{/accent}` — highlights text with an accent color.
+     * - `{#bold}...{/bold}` — renders bold text.
+     *
+     * Example: `'won {#accent}Alice{/accent} in'`
+     */
+    title: string;
+};
+
+declare type TV1RichMessageTheme = {
+    /** Rich message background color. Use a hex color. */
+    background: string;
+    buttonText: 'white' | 'dark';
+    /** Main accent color of the rich message, used for the sidebar, highlights, links, and buttons. Use a hex color. */
+    main: string;
+};
+
 declare type TV1SerializedError = {
     cause?: TV1SerializedError;
     message: string;
@@ -876,6 +970,10 @@ declare type TV1StorageMethods = {
 };
 
 declare type TV1SystemMethods = {
+    'v1.system.analytics.track': {
+        params: TV1AnalyticsTrackParams;
+        result: null;
+    };
     'v1.system.report.crash': {
         params: {
             data?: Record<string, unknown>;
@@ -1015,6 +1113,17 @@ declare type TV1TopUserEntry = {
 
 declare type TV1TopWindow = 'TOP_1D' | 'TOP_7D' | 'TOP_30D' | 'TOP_UNSPECIFIED';
 
+declare type TV1UiInteractionTrackParams = {
+    data: {
+        elementId: string;
+        elementType: 'banner' | 'button' | 'tile' | 'popup' | 'extensionButton';
+        interactionType: 'view' | 'click' | 'close' | 'dismiss';
+        optionSelected?: string;
+        pageSection?: string;
+    };
+    type: 'uiInteraction';
+};
+
 /**
  * User activity league. Ordered from lowest to highest activity rank:
  * - `grey` — new or low-activity users (level 1–9)

package/dist/index.d.ts

@@ -57,6 +57,7 @@ declare type TExtHelper = {
 
 declare type TExtHelperProps = {
     frameId: string;
+    lang: string;
     serverId: string;
     serverOrigin: string;
     serverSource: Window;
@@ -119,6 +120,8 @@ export declare type TV1ActionResult = {
     code: number;
 };
 
+export declare type TV1AnalyticsTrackParams = TV1UiInteractionTrackParams;
+
 declare type TV1ChatEvents = {
     /** Triggered on every new message in a chat */
     'v1.chat.message.received': {
@@ -168,6 +171,20 @@ declare type TV1ChatMethods = {
         };
         result: null;
     };
+    /**
+     * Send a rich message to the chat with customizable colors.
+     *
+     * The message is sent locally on behalf of the extension. It is not sent to the server or broadcast — each user sees it only in their own local chat feed.
+     *
+     * Because the message is local, it is **not persisted**: it disappears from chat history when the page is reloaded.
+     *
+     * Required permission:
+     * - `richMessage`
+     */
+    'v1.chat.richMessage.send': {
+        params: TV1RichMessage;
+        result: null;
+    };
     /** Use this method to send a message in the chat as a bot or model.
      *  The message is sent locally to each user and looks like a normal chat message. The message is **not persisted** and will disappear from the chat after the page is reloaded.
      * */
@@ -306,6 +323,19 @@ declare type TV1ExtMethods = {
         params: null;
         result: TV1ExtContext;
     };
+    /**
+     * Returns the tag from which the user navigated to the model.
+     * `tag` is `null` when the source tag is unknown.
+     *
+     * Required permission:
+     * - `modelTag`
+     */
+    'v1.ext.modelTag.get': {
+        params: null;
+        result: {
+            tag: TV1ExtModelTag | null;
+        };
+    };
     'v1.ext.movableOverlay.update': {
         params: {
             message?: string;
@@ -322,6 +352,8 @@ declare type TV1ExtMethods = {
     /** Opens Stripchat sign-up dialog for anonymous users. Use this when your extension requires a registered account to function */
     'v1.ext.signup.open': {
         params: {
+            /** Optional source string to identify the origin of the sign-up request. Internal use only */
+            source?: string;
             type: 'user';
         };
         result: null;
@@ -400,6 +432,21 @@ export declare type TV1ExtModel = {
     username: string;
 };
 
+/**
+ * Tag from which the user navigated to the model.
+ *
+ * Required permission:
+ * - `modelTag`
+ */
+export declare type TV1ExtModelTag = {
+    /** Tag identifier, for example `autoTagNew` */
+    id: string;
+    /** Primary tag the tag belongs to */
+    primaryTagId: 'girls' | 'men' | 'trans' | 'couples';
+    /** Tag URL path, for example `girls/new` */
+    url: string;
+};
+
 export declare type TV1ExtSettings = unknown;
 
 export declare type TV1ExtUser = TV1ExtGuestUser | TV1ExtLoggedInUser;
@@ -580,6 +627,52 @@ declare type TV1PrivateMethods = {
     };
 };
 
+export declare type TV1RichMessage = {
+    /** The main action appearance. It opens the extension tab on click. If omitted, the default action is a link. */
+    action?: {
+        text?: string;
+        type: 'link' | 'button';
+    };
+    /** One of the predefined extension icons. If omitted, the icon from the manifest is used. */
+    icon?: 'sex-toy-1' | 'sex-toy-2' | 'spicy-pepper';
+    /**
+     * Rich message subtitle.
+     *
+     * Supports inline markup tags:
+     * - `{#primary}...{/primary}` — uses the primary text color.
+     * - `{#secondary}...{/secondary}` — uses the secondary text color.
+     * - `{#accent}...{/accent}` — highlights text with an accent color.
+     * - `{#bold}...{/bold}` — renders bold text.
+     *
+     * Example: `'won {#accent}Alice{/accent} in'`
+     */
+    subtitle: string;
+    /** Optional custom theme. If omitted, the default theme is used. */
+    theme?: {
+        [Property in TTheme]?: TV1RichMessageTheme;
+    };
+    /**
+     * Rich message title.
+     *
+     * Supports inline markup tags:
+     * - `{#primary}...{/primary}` — uses the primary text color.
+     * - `{#secondary}...{/secondary}` — uses the secondary text color.
+     * - `{#accent}...{/accent}` — highlights text with an accent color.
+     * - `{#bold}...{/bold}` — renders bold text.
+     *
+     * Example: `'won {#accent}Alice{/accent} in'`
+     */
+    title: string;
+};
+
+export declare type TV1RichMessageTheme = {
+    /** Rich message background color. Use a hex color. */
+    background: string;
+    buttonText: 'white' | 'dark';
+    /** Main accent color of the rich message, used for the sidebar, highlights, links, and buttons. Use a hex color. */
+    main: string;
+};
+
 declare type TV1SerializedError = {
     cause?: TV1SerializedError;
     message: string;
@@ -937,6 +1030,10 @@ export declare type TV1StorageStringSetError = TV1ExtensionError<TV1StorageStrin
 export declare type TV1StorageStringSetErrorCode = 'ERR_CODE_UNSPECIFIED' | 'ERR_STORAGE_VALUE_SIZE_LIMIT_EXCEEDED';
 
 declare type TV1SystemMethods = {
+    'v1.system.analytics.track': {
+        params: TV1AnalyticsTrackParams;
+        result: null;
+    };
     'v1.system.report.crash': {
         params: {
             data?: Record<string, unknown>;
@@ -1076,6 +1173,17 @@ export declare type TV1TopUserEntry = {
 
 export declare type TV1TopWindow = 'TOP_1D' | 'TOP_7D' | 'TOP_30D' | 'TOP_UNSPECIFIED';
 
+export declare type TV1UiInteractionTrackParams = {
+    data: {
+        elementId: string;
+        elementType: 'banner' | 'button' | 'tile' | 'popup' | 'extensionButton';
+        interactionType: 'view' | 'click' | 'close' | 'dismiss';
+        optionSelected?: string;
+        pageSection?: string;
+    };
+    type: 'uiInteraction';
+};
+
 /**
  * User activity league. Ordered from lowest to highest activity rank:
  * - `grey` — new or low-activity users (level 1–9)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stripchatdev/ext-helper",
   "private": false,
-  "version": "0.3.0",
+  "version": "0.3.2",
   "license": "Apache-2.0",
   "type": "module",
   "module": "./dist/ext-helper.js",