@stripchatdev/ext-helper 0.2.2 → 0.3.0

package/dist/ext-helper.js

@@ -1,4 +1,4 @@
-const L = (e) => !!e && typeof e == "object" && "protocol" in e && e.protocol === "platform_pubsub" && "version" in e && e.version === "1.0", I = (e) => e, k = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+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;
 (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";
@@ -8,12 +8,12 @@ class y extends Error {
     super(`${r} (${t})`), this.name = "ULIDError", this.code = t;
   }
 }
-function O(e) {
+function A(e) {
   const t = Math.floor(e() * 32) % 32;
-  return k.charAt(t);
+  return P.charAt(t);
 }
-function A(e) {
-  const t = x(), r = t && (t.crypto || t.msCrypto) || null;
+function x(e) {
+  const t = C(), r = t && (t.crypto || t.msCrypto) || null;
   if (typeof (r == null ? void 0 : r.getRandomValues) == "function")
     return () => {
       const n = new Uint8Array(1);
@@ -23,16 +23,16 @@ function A(e) {
     return () => r.randomBytes(1).readUInt8() / 255;
   throw new y(f.PRNGDetectFailure, "Failed to find a reliable PRNG");
 }
-function x() {
-  return F() ? self : typeof window < "u" ? window : typeof global < "u" ? global : typeof globalThis < "u" ? globalThis : null;
+function C() {
+  return j() ? self : typeof window < "u" ? window : typeof global < "u" ? global : typeof globalThis < "u" ? globalThis : null;
 }
-function C(e, t) {
+function D(e, t) {
   let r = "";
   for (; e > 0; e--)
-    r = O(t) + r;
+    r = A(t) + r;
   return r;
 }
-function D(e, t = 10) {
+function F(e, t = 10) {
   if (isNaN(e))
     throw new y(f.EncodeTimeValueMalformed, `Time must be a number: ${e}`);
   if (e > 281474976710655)
@@ -43,17 +43,17 @@ function D(e, t = 10) {
     throw new y(f.EncodeTimeValueMalformed, `Time must be an integer: ${e}`);
   let r, n = "";
   for (let s = t; s > 0; s--)
-    r = e % 32, n = k.charAt(r) + n, e = (e - r) / 32;
+    r = e % 32, n = P.charAt(r) + n, e = (e - r) / 32;
   return n;
 }
-function F() {
+function j() {
   return typeof WorkerGlobalScope < "u" && self instanceof WorkerGlobalScope;
 }
 function E(e, t) {
-  const r = t || A(), n = !e || isNaN(e) ? Date.now() : e;
-  return D(n, 10) + C(16, r);
+  const r = t || x(), n = !e || isNaN(e) ? Date.now() : e;
+  return F(n, 10) + D(16, r);
 }
-const j = ({ seq: e, uniqId: t }) => (r) => ({
+const G = ({ seq: e, uniqId: t }) => (r) => ({
   ...{
     protocol: "platform_pubsub",
     version: "1.0",
@@ -62,22 +62,22 @@ const j = ({ seq: e, uniqId: t }) => (r) => ({
     timestamp: Date.now()
   },
   ...r
-}), v = j({
+}), v = G({
   uniqId: () => E(),
   seq: () => E()
 });
-class G {
+class z {
   constructor(t) {
     this.eventHandlerMap = /* @__PURE__ */ new Map(), this.transportMessageHandler = (s) => {
-      const { data: o, senderId: a } = s;
-      if (L(o)) {
+      const { data: o, senderId: i } = s;
+      if (O(o)) {
         if (o.type === "event") {
-          const { eventName: i } = o, c = this.eventHandlerMap.get(i);
+          const { eventName: a } = o, c = this.eventHandlerMap.get(a);
           if (!c)
             return;
           c.forEach((h) => {
             try {
-              h(o.data, a);
+              h(o.data, i);
             } catch (m) {
               console.error("[PubSubSubscriber] transportMessageHandler: failed to handle income message", m);
             }
@@ -112,10 +112,10 @@ class G {
     }
   }
 }
-const z = !!Error.captureStackTrace, B = "APP_ERROR";
+const B = !!Error.captureStackTrace, V = "APP_ERROR";
 class b extends Error {
   constructor(t, r) {
-    super(t), this.name = new.target.name || B, this.cause = r, z && Error.captureStackTrace(this, this.constructor);
+    super(t), this.name = new.target.name || V, this.cause = r, B && Error.captureStackTrace(this, this.constructor);
   }
   static serializeCause(t) {
     return t instanceof b ? t.toJSON() : t instanceof Error ? { name: t.name, message: t.message } : t !== null && typeof t == "object" ? t : String(t);
@@ -136,23 +136,24 @@ class b extends Error {
     }
   }
 }
-const V = {
+const X = {
   INTERNAL_ERROR: "INTERNAL_ERROR"
-}, X = "RPC_ERROR";
-class W extends b {
+}, W = "RPC_ERROR";
+class $ extends b {
   constructor(t) {
-    super(t.message || "rpc error", t.cause), this.name = X, this.code = (t == null ? void 0 : t.code) || V.INTERNAL_ERROR, this.method = t.method, this.params = t.params;
+    super(t.message || "rpc error", t.cause), this.name = W, this.code = (t == null ? void 0 : t.code) || X.INTERNAL_ERROR, this.details = t.details, this.method = t.method, this.params = t.params;
   }
   toJSON() {
     return {
       ...super.toJSON(),
       code: this.code,
+      details: this.details,
       method: this.method,
       params: this.params
     };
   }
 }
-const $ = (e) => !!e && typeof e == "object" && "protocol" in e && e.protocol === "platform_rpc" && "version" in e && e.version === "1.0", J = ({ uniqId: e }) => (t) => ({
+const U = (e) => !!e && typeof e == "object" && "protocol" in e && e.protocol === "platform_rpc" && "version" in e && e.version === "1.0", J = ({ uniqId: e }) => (t) => ({
   ...{
     requestId: e(),
     protocol: "platform_rpc",
@@ -160,30 +161,30 @@ const $ = (e) => !!e && typeof e == "object" && "protocol" in e && e.protocol ==
     timestamp: Date.now()
   },
   ...t
-}), U = J({
+}), K = J({
   uniqId: () => E()
 });
-class K {
+class Z {
   constructor(t) {
     this.pendingEntryMap = /* @__PURE__ */ new Map(), this.transportMessageHandler = (s) => {
       const { data: o } = s;
-      if ($(o)) {
+      if (U(o)) {
         if (o.type === "response" && o.status === "ok") {
-          const a = this.pendingEntryMap.get(o.requestId);
-          if (!a) {
+          const i = this.pendingEntryMap.get(o.requestId);
+          if (!i) {
             console.error("[RpcClient] transportMessageHandler: got success response without pending request", o);
             return;
           }
-          this.pendingEntryMap.delete(o.requestId), a.resolve(o.result);
+          this.pendingEntryMap.delete(o.requestId), i.resolve(o.result);
           return;
         }
         if (o.type === "response" && o.status === "error") {
-          const a = this.pendingEntryMap.get(o.requestId);
-          if (!a) {
+          const i = this.pendingEntryMap.get(o.requestId);
+          if (!i) {
             console.error("[RpcClient] transportMessageHandler: got error response without pending request", o);
             return;
           }
-          this.pendingEntryMap.delete(o.requestId), a.reject(new W(o.error));
+          this.pendingEntryMap.delete(o.requestId), i.reject(new $(o.error));
           return;
         }
         console.error("[RpcClient] transportMessageHandler: invalid message schema", o);
@@ -193,18 +194,18 @@ class K {
     this.serverId = r, this.transport = n, this.transport.onMessage(this.transportMessageHandler);
   }
   makeRequest(t, r) {
-    const n = U({
+    const n = K({
       type: "request",
       method: t,
       params: r
-    }), s = new Promise((o, a) => {
+    }), s = new Promise((o, i) => {
       this.pendingEntryMap.set(n.requestId, {
         method: t,
-        resolve: (i) => {
-          o(i);
+        resolve: (a) => {
+          o(a);
         },
-        reject: (i) => {
-          a(i);
+        reject: (a) => {
+          i(a);
         }
       });
     });
@@ -212,31 +213,31 @@ class K {
       this.transport.send(this.serverId, n);
     } catch (o) {
       console.error("[RpcClient] makeRequest: failed to send rpc message", o);
-      const a = this.pendingEntryMap.get(n.requestId);
-      a && (this.pendingEntryMap.delete(n.requestId), a.reject(o));
+      const i = this.pendingEntryMap.get(n.requestId);
+      i && (this.pendingEntryMap.delete(n.requestId), i.reject(o));
     }
     return s;
   }
 }
-const Z = (e) => !!e && typeof e == "object" && "protocol" in e && e.protocol === "platform_transport" && "version" in e && e.version === "1.0", Q = ({ uniqId: e }) => (t) => ({
+const Q = (e) => !!e && typeof e == "object" && "protocol" in e && e.protocol === "platform_transport" && "version" in e && e.version === "1.0", Y = ({ uniqId: e }) => (t) => ({
   messageId: e(),
   protocol: "platform_transport",
   version: "1.0",
   ...t
-}), S = Q({
+}), S = Y({
   uniqId: E
 });
-class Y {
+class ee {
   constructor(t) {
     this.peers = /* @__PURE__ */ new Map(), this.handlers = /* @__PURE__ */ new Set(), this.onMessage = (s) => {
-      const o = (a) => {
-        const { data: i, origin: c, source: h } = a;
-        if (!h || !Z(i))
+      const o = (i) => {
+        const { data: a, origin: c, source: h } = i;
+        if (!h || !Q(a))
           return;
-        const { recipientId: m } = i;
+        const { recipientId: m } = a;
         if (!(m !== this.transportId || !this.findPeer(h, c)))
           try {
-            s(i);
+            s(a);
           } catch (w) {
             console.error("[PostMessageTransport] onMessage: failed to call cb on message", w);
           }
@@ -295,9 +296,9 @@ class Y {
 const g = {
   name: "unknownError",
   message: "unknown error"
-}, P = (e, t = 3, r = 0) => {
+}, q = (e, t = 3, r = 0) => {
   if (e instanceof Error) {
-    const n = r < t && e.cause ? P(e.cause, t, r + 1) : void 0;
+    const n = r < t && e.cause ? q(e.cause, t, r + 1) : void 0;
     return {
       name: e.name,
       message: e.message,
@@ -328,10 +329,10 @@ const g = {
       };
     }
   return g;
-}, q = (e) => {
+}, _ = (e) => {
   const t = [];
   if (e instanceof Error)
-    t.push(e.message), "cause" in e && t.push(q(e.cause));
+    t.push(e.message), "cause" in e && t.push(_(e.cause));
   else
     try {
       const r = JSON.stringify(e);
@@ -340,7 +341,7 @@ const g = {
       t.push("failed to get chained error message: unserializable error object");
     }
   return t.join(":");
-}, ee = [
+}, te = [
   // browser internals — harmless noise
   /resizeObserver loop/ig,
   // cross-origin script errors with zero useful info
@@ -363,29 +364,29 @@ const g = {
   // generic network noise already captured by fetch/xhr integrations
   /networkError when attempting to fetch resource/ig,
   /load failed/ig
-], te = (e) => ee.some((t) => (t.lastIndex = 0, t.test(e))), re = (e) => {
-  const t = q(e.error), r = typeof e.data == "object" && "message" in e.data && typeof e.data.message == "string" ? e.data.message : "";
+], 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 : "";
   return [t, r].filter((n) => !!n).join(":");
-}, ne = (e) => e.data && typeof e.data == "object" && "filename" in e.data ? String(e.data.filename ?? "") : "", se = (e) => {
-  const t = re(e), r = ne(e);
-  return r && /^(chrome|moz|safari)-extension:\/\//.test(r) ? !0 : !!t && te(t);
-}, oe = "get", ae = (e, t) => {
+}, 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) => {
   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()) || oe,
+    method: n || ((s = t == null ? void 0 : t.method) == null ? void 0 : s.toString()) || ie,
     url: r
   };
-}, ie = (e, t, r) => ({
+}, ce = (e, t, r) => ({
   statusCode: r.status,
   ...ae(e, t)
-}), ce = (e) => {
+}), ue = (e) => {
   const t = window.fetch;
   Object.defineProperty(window, "fetch", {
     value: async (n, s) => {
       try {
-        const o = new Error("synthetic error"), a = await t(n, s), i = a.clone(), c = ie(n, s, i);
-        if (a.status >= 500) {
+        const o = new Error("synthetic error"), i = await t(n, s), a = i.clone(), c = ce(n, s, a);
+        if (i.status >= 500) {
           const d = new Error("fetch response error");
           d.stack = o.stack, e.report({
             kind: "fetchResponseError",
@@ -399,8 +400,8 @@ const g = {
           blob: m,
           json: M,
           text: w
-        } = a;
-        return a.json = async function() {
+        } = i;
+        return i.json = async function() {
           try {
             return await M.call(this);
           } catch (d) {
@@ -414,7 +415,7 @@ const g = {
               }
             }), d;
           }
-        }, a.text = async function() {
+        }, i.text = async function() {
           try {
             return await w.call(this);
           } catch (d) {
@@ -428,7 +429,7 @@ const g = {
               }
             }), d;
           }
-        }, a.blob = async function() {
+        }, i.blob = async function() {
           try {
             return await m.call(this);
           } catch (d) {
@@ -442,7 +443,7 @@ const g = {
               }
             }), d;
           }
-        }, a.arrayBuffer = async function() {
+        }, i.arrayBuffer = async function() {
           try {
             return await h.call(this);
           } catch (d) {
@@ -456,7 +457,7 @@ const g = {
               }
             }), d;
           }
-        }, a;
+        }, i;
       } catch (o) {
         throw o instanceof Error && o.name === "AbortError", o;
       }
@@ -464,7 +465,7 @@ const g = {
     configurable: !0,
     writable: !0
   });
-}, ue = (e) => {
+}, de = (e) => {
   window.addEventListener("unhandledrejection", ({ reason: t }) => {
     e.report({
       type: "runtime",
@@ -484,18 +485,18 @@ const g = {
       }
     });
   });
-}, _ = Symbol("patchedXHLHttpRequest"), p = Symbol("requestInfo"), de = (e) => ({
+}, L = Symbol("patchedXHLHttpRequest"), p = Symbol("requestInfo"), le = (e) => ({
   statusCode: e.status,
   ...e[p]
-}), le = (e) => (e[p] || (e[p] = {}), e[p]), pe = (e) => {
-  e[_] = !0;
-}, he = (e) => e[_] === !0, fe = (e) => {
+}), pe = (e) => (e[p] || (e[p] = {}), e[p]), he = (e) => {
+  e[L] = !0;
+}, fe = (e) => e[L] === !0, me = (e) => {
   const t = XMLHttpRequest.prototype.send, r = XMLHttpRequest.prototype.open, n = function(...o) {
-    const [a, i] = o;
+    const [i, a] = o;
     this[p] = {
-      method: a,
-      url: typeof i == "string" ? i : i.toString()
-    }, he(this) || (pe(this), this.addEventListener("error", () => {
+      method: i,
+      url: typeof a == "string" ? a : a.toString()
+    }, fe(this) || (he(this), this.addEventListener("error", () => {
       const c = new Error("XMLHttpRequest network error");
       e.report({
         type: "network",
@@ -517,7 +518,7 @@ const g = {
         e.report({
           type: "network",
           kind: "xmlHttpRequestLoadError",
-          data: de(this),
+          data: le(this),
           error: c
         });
       }
@@ -534,15 +535,15 @@ const g = {
     }
   }, s = function(o) {
     try {
-      const a = le(this), i = new Error("XMLHttpRequest request initiator");
-      a.requestStack = i.stack, t.call(this, o);
-    } catch (a) {
+      const i = pe(this), a = new Error("XMLHttpRequest request initiator");
+      i.requestStack = a.stack, t.call(this, o);
+    } catch (i) {
       throw e.report({
         type: "network",
         kind: "xmlHttpRequestSendError",
-        error: a,
+        error: i,
         data: this[p]
-      }), a;
+      }), i;
     }
   };
   Object.defineProperty(XMLHttpRequest.prototype, "open", {
@@ -556,48 +557,48 @@ const g = {
   });
 };
 let N;
-class me {
+class ge {
   constructor(t) {
     this.onError = t;
   }
   report(t) {
-    if (se(t))
+    if (oe(t))
       return;
     const { error: r, ...n } = t;
     this.onError({
       ...n,
-      error: r ? P(r) : void 0
+      error: r ? q(r) : void 0
     });
   }
   init() {
     this.applyIntegrations();
   }
   applyIntegrations() {
-    N || (N = !0, ue(this), fe(this), ce(this));
+    N || (N = !0, de(this), me(this), ue(this));
   }
 }
-class ge {
+class ye {
   constructor(t) {
     const {
       frameId: r,
       serverId: n,
       serverOrigin: s,
       serverSource: o,
-      theme: a
-    } = t, i = {
+      theme: i
+    } = t, a = {
       id: n,
       origin: s,
       source: o
-    }, c = new Y({
+    }, c = new ee({
       transportId: r
     });
-    c.addPeer(i), this.rpcClient = new K({
+    c.addPeer(a), this.rpcClient = new Z({
       transport: c,
       serverId: n
-    }), this.subscriber = new G({
+    }), this.subscriber = new z({
       transport: c,
-      brokerId: i.id
-    }), document.documentElement.dataset.theme = a, this.crashReporter = new me((h) => {
+      brokerId: a.id
+    }), document.documentElement.dataset.theme = i, this.crashReporter = new ge((h) => {
       this.makeRequest("v1.system.report.crash", h);
     });
   }
@@ -613,20 +614,20 @@ class ge {
   bootstrap() {
     let t = { height: 0, width: 0 };
     const r = () => {
-      const i = document.body;
+      const a = document.body;
       return Math.max(
-        i.offsetHeight,
-        i.scrollHeight
+        a.offsetHeight,
+        a.scrollHeight
       );
     }, n = () => {
-      const i = document.body;
+      const a = document.body;
       return Math.max(
-        i.offsetWidth,
-        i.scrollWidth
+        a.offsetWidth,
+        a.scrollWidth
       );
     }, s = () => {
-      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 }));
+      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 }));
     };
     s(), new ResizeObserver(s).observe(document.body), new MutationObserver(s).observe(document.body, {
       childList: !0,
@@ -636,26 +637,26 @@ class ge {
     }), this.crashReporter.init();
   }
 }
-const ye = HTMLElement.prototype.focus, Ee = SVGElement.prototype.focus;
+const Ee = HTMLElement.prototype.focus, be = SVGElement.prototype.focus;
 function T(e) {
   const t = typeof e == "object" && e ? { ...e, preventScroll: !0 } : { preventScroll: !0 };
   if (this instanceof HTMLElement)
-    return ye.call(this, t);
-  if (this instanceof SVGElement)
     return Ee.call(this, t);
+  if (this instanceof SVGElement)
+    return be.call(this, t);
 }
-const be = HTMLFormElement.prototype.submit, we = HTMLFormElement.prototype.requestSubmit, Re = /* @__PURE__ */ new Set(["_top", "_blank", "_parent"]), R = (e) => !!e && Re.has(e.toLowerCase());
-function Me() {
+const we = HTMLFormElement.prototype.submit, Re = HTMLFormElement.prototype.requestSubmit, Me = /* @__PURE__ */ new Set(["_top", "_blank", "_parent"]), R = (e) => !!e && Me.has(e.toLowerCase());
+function Ie() {
   const e = this.getAttribute("target");
   if (!R(e))
-    return be.call(this);
+    return we.call(this);
 }
-function Ie(e) {
+function ve(e) {
   const t = (e == null ? void 0 : e.getAttribute("formtarget")) || this.getAttribute("target");
   if (!R(t))
-    return we.call(this, e);
+    return Re.call(this, e);
 }
-function ve(e) {
+function Se(e) {
   var s;
   const t = e.target;
   if (!(t instanceof HTMLFormElement))
@@ -679,7 +680,7 @@ const l = () => {
       });
     } catch {
     }
-}, Se = () => {
+}, Ne = () => {
   u(Window.prototype, "open", () => null), u(window, "open", () => null), u(Element.prototype, "scrollIntoView", l), u(
     Element.prototype,
     "scrollIntoViewIfNeeded",
@@ -688,25 +689,26 @@ const l = () => {
     HTMLVideoElement.prototype,
     "requestPictureInPicture",
     () => Promise.resolve({})
-  ), u(HTMLFormElement.prototype, "submit", Me), u(HTMLFormElement.prototype, "requestSubmit", Ie), typeof Location < "u" && (u(Location.prototype, "assign", l), u(Location.prototype, "replace", l), u(Location.prototype, "reload", l)), document.addEventListener("submit", ve, !0);
-};
-let H = !1;
-typeof window < "u" && typeof document < "u" && Se();
-const Ne = () => {
-  if (H)
+  ), 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;
+let k = !1;
+typeof window < "u" && typeof document < "u" && Ne();
+const He = () => {
+  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)
     throw new Error("failed to create ext helper, frameId is empty");
-  const s = new ge({
+  const s = new ye({
     serverId: "server",
     serverOrigin: t || window.parent.origin,
     serverSource: window.parent,
     frameId: n,
     theme: r
   });
-  return s.bootstrap(), H = !0, s;
+  return s.bootstrap(), k = !0, s;
 };
 export {
-  Ne as createExtHelper
+  He as createExtHelper,
+  Te as isExtensionError
 };

package/dist/helpers/index.d.ts

@@ -146,6 +146,10 @@ declare type TV1ActionResult = {
 declare type TV1ChatEvents = {
     /** Triggered on every new message in a chat */
     'v1.chat.message.received': {
+        /** Unique event id */
+        eventId: string;
+        /** Unique id of the message */
+        messageId: string;
         /** Text of the message */
         messageText: string;
         /** User who sent the message **/
@@ -469,6 +473,7 @@ declare type TV1GoalData = {
 declare type TV1GoalEvents = {
     /** Fired when any field of the active goal changes (description, isCompleted, tokensTarget, or tokensCollected), or the active goal is removed. */
     'v1.goal.updated': {
+        eventId: string;
         goal: TV1GoalData | null;
     };
 };
@@ -750,6 +755,12 @@ declare type TV1StorageMethods = {
         params: {
             /** Amount to add (may be negative). Must not be zero. */
             delta: string;
+            /**
+             * Unique key for idempotent storage writes, such as an eventId, messageId, or transactionId.
+             * Warning: Do not use unstable frontend-generated values because they may differ across tabs.
+             * Use the same stable value across tabs and devices.
+             */
+            idempotencyKey?: string;
             key: string;
             /** Opaque payload forwarded to server-side payment/policy validation. */
             paymentContext?: string;
@@ -764,6 +775,12 @@ declare type TV1StorageMethods = {
     /** Reset an integer counter to 0. */
     'v1.storage.int.reset': {
         params: {
+            /**
+             * Unique key for idempotent storage writes, such as an eventId, messageId, or transactionId.
+             * Warning: Do not use unstable frontend-generated values because they may differ across tabs.
+             * Use the same stable value across tabs and devices.
+             */
+            idempotencyKey?: string;
             key: string;
         };
         result: {
@@ -802,14 +819,25 @@ declare type TV1StorageMethods = {
     };
     'v1.storage.string.append': {
         params: {
+            /**
+             * Unique key for idempotent storage writes, such as an eventId, messageId, or transactionId.
+             * Warning: Do not use unstable frontend-generated values because they may differ across tabs.
+             * Use the same stable value across tabs and devices.
+             */
+            idempotencyKey?: string;
             key: string;
             /** Auto-delete the key after this many seconds. Omit or 0 = no expiry. */
             /** @format int64 */
             ttl?: string;
+            /**
+             * Append payload (at most 50000 UTF-8 bytes). Resulting stored value must also fit within 50000 bytes.
+             * @maxLength 50000
+             */
             value: string;
         };
         result: {
             success: boolean;
+            value: string;
         };
     };
     'v1.storage.string.get': {
@@ -837,14 +865,25 @@ declare type TV1StorageMethods = {
     };
     'v1.storage.string.set': {
         params: {
+            /**
+             * Unique key for idempotent storage writes, such as an eventId, messageId, or transactionId.
+             * Warning: Do not use unstable frontend-generated values because they may differ across tabs.
+             * Use the same stable value across tabs and devices.
+             */
+            idempotencyKey?: string;
             key: string;
             /** Auto-delete the key after this many seconds. Omit or 0 = no expiry. */
             /** @format int64 */
             ttl?: string;
+            /**
+             * Value (at most 50000 UTF-8 bytes).
+             * @maxLength 50000
+             */
             value: string;
         };
         result: {
             success: boolean;
+            value: string;
         };
     };
     /**
@@ -959,11 +998,15 @@ declare type TV1TipData = {
 declare type TV1TipEvents = {
     /** Fired when the tip menu has been updated.*/
     'v1.tipMenu.updated': {
+        /** Unique event id */
+        eventId: string;
         /** The current tip menu data. */
         tipMenu: TV1TipMenu;
     };
     /** Fired on every tip in chat for both model and user. Doesn't fire on private tips during public shows */
     'v1.tokens.spent': {
+        /** Unique event id */
+        eventId: string;
         tipData: TV1TipData;
     };
 };

package/dist/helpers/react.d.ts

@@ -80,6 +80,10 @@ declare type TV1ActionResult = {
 declare type TV1ChatEvents = {
     /** Triggered on every new message in a chat */
     'v1.chat.message.received': {
+        /** Unique event id */
+        eventId: string;
+        /** Unique id of the message */
+        messageId: string;
         /** Text of the message */
         messageText: string;
         /** User who sent the message **/
@@ -403,6 +407,7 @@ declare type TV1GoalData = {
 declare type TV1GoalEvents = {
     /** Fired when any field of the active goal changes (description, isCompleted, tokensTarget, or tokensCollected), or the active goal is removed. */
     'v1.goal.updated': {
+        eventId: string;
         goal: TV1GoalData | null;
     };
 };
@@ -684,6 +689,12 @@ declare type TV1StorageMethods = {
         params: {
             /** Amount to add (may be negative). Must not be zero. */
             delta: string;
+            /**
+             * Unique key for idempotent storage writes, such as an eventId, messageId, or transactionId.
+             * Warning: Do not use unstable frontend-generated values because they may differ across tabs.
+             * Use the same stable value across tabs and devices.
+             */
+            idempotencyKey?: string;
             key: string;
             /** Opaque payload forwarded to server-side payment/policy validation. */
             paymentContext?: string;
@@ -698,6 +709,12 @@ declare type TV1StorageMethods = {
     /** Reset an integer counter to 0. */
     'v1.storage.int.reset': {
         params: {
+            /**
+             * Unique key for idempotent storage writes, such as an eventId, messageId, or transactionId.
+             * Warning: Do not use unstable frontend-generated values because they may differ across tabs.
+             * Use the same stable value across tabs and devices.
+             */
+            idempotencyKey?: string;
             key: string;
         };
         result: {
@@ -736,14 +753,25 @@ declare type TV1StorageMethods = {
     };
     'v1.storage.string.append': {
         params: {
+            /**
+             * Unique key for idempotent storage writes, such as an eventId, messageId, or transactionId.
+             * Warning: Do not use unstable frontend-generated values because they may differ across tabs.
+             * Use the same stable value across tabs and devices.
+             */
+            idempotencyKey?: string;
             key: string;
             /** Auto-delete the key after this many seconds. Omit or 0 = no expiry. */
             /** @format int64 */
             ttl?: string;
+            /**
+             * Append payload (at most 50000 UTF-8 bytes). Resulting stored value must also fit within 50000 bytes.
+             * @maxLength 50000
+             */
             value: string;
         };
         result: {
             success: boolean;
+            value: string;
         };
     };
     'v1.storage.string.get': {
@@ -771,14 +799,25 @@ declare type TV1StorageMethods = {
     };
     'v1.storage.string.set': {
         params: {
+            /**
+             * Unique key for idempotent storage writes, such as an eventId, messageId, or transactionId.
+             * Warning: Do not use unstable frontend-generated values because they may differ across tabs.
+             * Use the same stable value across tabs and devices.
+             */
+            idempotencyKey?: string;
             key: string;
             /** Auto-delete the key after this many seconds. Omit or 0 = no expiry. */
             /** @format int64 */
             ttl?: string;
+            /**
+             * Value (at most 50000 UTF-8 bytes).
+             * @maxLength 50000
+             */
             value: string;
         };
         result: {
             success: boolean;
+            value: string;
         };
     };
     /**
@@ -893,11 +932,15 @@ declare type TV1TipData = {
 declare type TV1TipEvents = {
     /** Fired when the tip menu has been updated.*/
     'v1.tipMenu.updated': {
+        /** Unique event id */
+        eventId: string;
         /** The current tip menu data. */
         tipMenu: TV1TipMenu;
     };
     /** Fired on every tip in chat for both model and user. Doesn't fire on private tips during public shows */
     'v1.tokens.spent': {
+        /** Unique event id */
+        eventId: string;
         tipData: TV1TipData;
     };
 };

package/dist/index.d.ts

@@ -11,6 +11,8 @@ declare class ExtHelper implements TExtHelper {
     bootstrap(): void;
 }
 
+export declare const isExtensionError: <TMethod extends TExtensionMethodName | undefined = undefined>(error: unknown) => error is TExtensionError<TMethod>;
+
 export declare type IV1IntIncrementFailureReason = 'INT_INCREMENT_FAILURE_REASON_UNSPECIFIED' | 'INT_INCREMENT_FAILURE_REASON_NONE' | 'INT_INCREMENT_FAILURE_REASON_VALIDATION_DENIED';
 
 export declare type IV1ResolveSlotPage = (slotType: string, context: TV1ExtContext, extSettings: TV1ExtSettings) => void;
@@ -39,9 +41,13 @@ export declare type TApiSchema = TAnyApiSchema<TEvents, TMethods>;
 
 export declare type TEvents = TV1Events;
 
+declare type TExtensionError<TMethod extends TExtensionMethodName | undefined = undefined> = TMethod extends keyof TV1MethodErrors ? TV1MethodErrors[TMethod] : TV1ExtensionError;
+
 /** UUID */
 export declare type TExtensionId = string;
 
+declare type TExtensionMethodName = Extract<keyof TApiSchema['methods'], string>;
+
 declare type TExtHelper = {
     bootstrap(): void;
     makeRequest<M extends Extract<keyof TApiContract['methods'], string>>(method: M, params: TApiContract['methods'][M]['params']): Promise<TApiContract['methods'][M]['result']>;
@@ -116,6 +122,10 @@ export declare type TV1ActionResult = {
 declare type TV1ChatEvents = {
     /** Triggered on every new message in a chat */
     'v1.chat.message.received': {
+        /** Unique event id */
+        eventId: string;
+        /** Unique id of the message */
+        messageId: string;
         /** Text of the message */
         messageText: string;
         /** User who sent the message **/
@@ -192,6 +202,12 @@ export declare type TV1ExtContext = {
     user?: TV1ExtUser;
 };
 
+export declare type TV1ExtensionError<TCode extends string = string, TDetails extends Record<string, unknown> = Record<string, unknown>> = {
+    code: TCode;
+    details?: TDetails;
+    message: string;
+};
+
 declare type TV1ExtEvents = {
     'v1.ext.activity.available': null;
     'v1.ext.activity.busy': null;
@@ -439,6 +455,7 @@ export declare type TV1GoalData = {
 declare type TV1GoalEvents = {
     /** Fired when any field of the active goal changes (description, isCompleted, tokensTarget, or tokensCollected), or the active goal is removed. */
     'v1.goal.updated': {
+        eventId: string;
         goal: TV1GoalData | null;
     };
 };
@@ -453,6 +470,11 @@ declare type TV1GoalMethods = {
     };
 };
 
+export declare type TV1MethodErrors = {
+    'v1.storage.string.append': TV1StorageStringAppendError;
+    'v1.storage.string.set': TV1StorageStringSetError;
+};
+
 export declare type TV1Methods = TV1ExtMethods & TV1SystemMethods & TV1PaymentMethods & TV1ModelMethods & TV1ChatMethods & TV1PrivateMethods & TV1MonitoringMethods & TV1SessionMethods & TV1StorageMethods & TV1TipMethods & TV1GoalMethods & TV1FanClubMethods;
 
 declare type TV1ModelEvents = {
@@ -720,6 +742,12 @@ declare type TV1StorageMethods = {
         params: {
             /** Amount to add (may be negative). Must not be zero. */
             delta: string;
+            /**
+             * Unique key for idempotent storage writes, such as an eventId, messageId, or transactionId.
+             * Warning: Do not use unstable frontend-generated values because they may differ across tabs.
+             * Use the same stable value across tabs and devices.
+             */
+            idempotencyKey?: string;
             key: string;
             /** Opaque payload forwarded to server-side payment/policy validation. */
             paymentContext?: string;
@@ -734,6 +762,12 @@ declare type TV1StorageMethods = {
     /** Reset an integer counter to 0. */
     'v1.storage.int.reset': {
         params: {
+            /**
+             * Unique key for idempotent storage writes, such as an eventId, messageId, or transactionId.
+             * Warning: Do not use unstable frontend-generated values because they may differ across tabs.
+             * Use the same stable value across tabs and devices.
+             */
+            idempotencyKey?: string;
             key: string;
         };
         result: {
@@ -772,14 +806,25 @@ declare type TV1StorageMethods = {
     };
     'v1.storage.string.append': {
         params: {
+            /**
+             * Unique key for idempotent storage writes, such as an eventId, messageId, or transactionId.
+             * Warning: Do not use unstable frontend-generated values because they may differ across tabs.
+             * Use the same stable value across tabs and devices.
+             */
+            idempotencyKey?: string;
             key: string;
             /** Auto-delete the key after this many seconds. Omit or 0 = no expiry. */
             /** @format int64 */
             ttl?: string;
+            /**
+             * Append payload (at most 50000 UTF-8 bytes). Resulting stored value must also fit within 50000 bytes.
+             * @maxLength 50000
+             */
             value: string;
         };
         result: {
             success: boolean;
+            value: string;
         };
     };
     'v1.storage.string.get': {
@@ -807,14 +852,25 @@ declare type TV1StorageMethods = {
     };
     'v1.storage.string.set': {
         params: {
+            /**
+             * Unique key for idempotent storage writes, such as an eventId, messageId, or transactionId.
+             * Warning: Do not use unstable frontend-generated values because they may differ across tabs.
+             * Use the same stable value across tabs and devices.
+             */
+            idempotencyKey?: string;
             key: string;
             /** Auto-delete the key after this many seconds. Omit or 0 = no expiry. */
             /** @format int64 */
             ttl?: string;
+            /**
+             * Value (at most 50000 UTF-8 bytes).
+             * @maxLength 50000
+             */
             value: string;
         };
         result: {
             success: boolean;
+            value: string;
         };
     };
     /**
@@ -872,6 +928,14 @@ declare type TV1StorageMethods = {
     };
 };
 
+export declare type TV1StorageStringAppendError = TV1ExtensionError<TV1StorageStringAppendErrorCode>;
+
+export declare type TV1StorageStringAppendErrorCode = TV1StorageStringSetErrorCode;
+
+export declare type TV1StorageStringSetError = TV1ExtensionError<TV1StorageStringSetErrorCode>;
+
+export declare type TV1StorageStringSetErrorCode = 'ERR_CODE_UNSPECIFIED' | 'ERR_STORAGE_VALUE_SIZE_LIMIT_EXCEEDED';
+
 declare type TV1SystemMethods = {
     'v1.system.report.crash': {
         params: {
@@ -929,11 +993,15 @@ export declare type TV1TipData = {
 declare type TV1TipEvents = {
     /** Fired when the tip menu has been updated.*/
     'v1.tipMenu.updated': {
+        /** Unique event id */
+        eventId: string;
         /** The current tip menu data. */
         tipMenu: TV1TipMenu;
     };
     /** Fired on every tip in chat for both model and user. Doesn't fire on private tips during public shows */
     'v1.tokens.spent': {
+        /** Unique event id */
+        eventId: string;
         tipData: TV1TipData;
     };
 };

package/package.json

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