@stripchatdev/ext-helper 0.2.3 → 0.3.1

package/dist/ext-helper.js

@@ -1,19 +1,19 @@
-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";
-var f;
+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 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;
   }
 }
-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 = D(), r = t && (t.crypto || t.msCrypto) || null;
   if (typeof (r == null ? void 0 : r.getRandomValues) == "function")
     return () => {
       const n = new Uint8Array(1);
@@ -21,39 +21,39 @@ function A(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 x() {
-  return F() ? self : typeof window < "u" ? window : typeof global < "u" ? global : typeof globalThis < "u" ? globalThis : null;
+function D() {
+  return j() ? self : typeof window < "u" ? window : typeof global < "u" ? global : typeof globalThis < "u" ? globalThis : null;
 }
 function C(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}`);
+    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 = 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) + C(16, r);
 }
-const j = ({ seq: e, uniqId: t }) => (r) => ({
+const G = ({ seq: e, uniqId: t }) => (r) => ({
   ...{
     protocol: "platform_pubsub",
     version: "1.0",
@@ -62,24 +62,24 @@ 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)) {
+      if (O(o)) {
         if (o.type === "event") {
           const { eventName: i } = o, c = this.eventHandlerMap.get(i);
           if (!c)
             return;
-          c.forEach((h) => {
+          c.forEach((l) => {
             try {
-              h(o.data, a);
-            } 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;
@@ -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,14 +161,14 @@ 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) {
@@ -183,7 +184,7 @@ class K {
             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), a.reject(new $(o.error));
           return;
         }
         console.error("[RpcClient] transportMessageHandler: invalid message schema", o);
@@ -193,7 +194,7 @@ 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
@@ -218,23 +219,23 @@ class K {
     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 { data: i, origin: c, source: l } = a;
+        if (!l || !Q(i))
           return;
-        const { recipientId: m } = i;
-        if (!(m !== this.transportId || !this.findPeer(h, c)))
+        const { recipientId: f } = i;
+        if (!(f !== this.transportId || !this.findPeer(l, c)))
           try {
             s(i);
           } catch (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) => {
+}, L = (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(L(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,28 +364,28 @@ 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 = 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(":");
-}, 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);
+}, 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()) || oe,
+    method: n || ((s = t == null ? void 0 : t.method) == null ? void 0 : s.toString()) || ae,
     url: r
   };
-}, ie = (e, t, r) => ({
+}, ce = (e, t, r) => ({
   statusCode: r.status,
-  ...ae(e, t)
-}), ce = (e) => {
+  ...ie(e, t)
+}), 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);
+        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({
@@ -395,8 +396,8 @@ const g = {
           });
         }
         const {
-          arrayBuffer: h,
-          blob: m,
+          arrayBuffer: l,
+          blob: f,
           json: M,
           text: w
         } = a;
@@ -430,7 +431,7 @@ const g = {
           }
         }, a.blob = async function() {
           try {
-            return await m.call(this);
+            return await f.call(this);
           } catch (d) {
             throw e.report({
               type: "network",
@@ -444,7 +445,7 @@ const g = {
           }
         }, a.arrayBuffer = async function() {
           try {
-            return await h.call(this);
+            return await l.call(this);
           } catch (d) {
             throw e.report({
               type: "network",
@@ -464,7 +465,7 @@ const g = {
     configurable: !0,
     writable: !0
   });
-}, ue = (e) => {
+}, de = (e) => {
   window.addEventListener("unhandledrejection", ({ reason: t }) => {
     e.report({
       type: "runtime",
@@ -484,23 +485,23 @@ const g = {
       }
     });
   });
-}, _ = Symbol("patchedXHLHttpRequest"), p = Symbol("requestInfo"), de = (e) => ({
+}, _ = Symbol("patchedXHLHttpRequest"), h = Symbol("requestInfo"), le = (e) => ({
   statusCode: e.status,
-  ...e[p]
-}), le = (e) => (e[p] || (e[p] = {}), e[p]), pe = (e) => {
+  ...e[h]
+}), pe = (e) => (e[h] || (e[h] = {}), e[h]), he = (e) => {
   e[_] = !0;
-}, he = (e) => e[_] === !0, fe = (e) => {
+}, fe = (e) => e[_] === !0, me = (e) => {
   const t = XMLHttpRequest.prototype.send, r = XMLHttpRequest.prototype.open, n = function(...o) {
     const [a, i] = o;
-    this[p] = {
+    this[h] = {
       method: a,
       url: typeof i == "string" ? i : i.toString()
-    }, he(this) || (pe(this), this.addEventListener("error", () => {
+    }, 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", () => {
@@ -508,7 +509,7 @@ const g = {
       e.report({
         type: "network",
         kind: "xmlHttpRequestTimeoutError",
-        data: this[p],
+        data: this[h],
         error: c
       });
     }), this.addEventListener("load", () => {
@@ -517,7 +518,7 @@ const g = {
         e.report({
           type: "network",
           kind: "xmlHttpRequestLoadError",
-          data: de(this),
+          data: le(this),
           error: c
         });
       }
@@ -529,19 +530,19 @@ const g = {
         type: "network",
         kind: "xmlHttpRequestOpenError",
         error: c,
-        data: this[p]
+        data: this[h]
       }), c;
     }
   }, s = function(o) {
     try {
-      const a = le(this), i = new Error("XMLHttpRequest request initiator");
+      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: a,
-        data: this[p]
+        data: this[h]
       }), a;
     }
   };
@@ -556,49 +557,50 @@ 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 = {
-      id: n,
-      origin: s,
-      source: o
-    }, c = new Y({
+      lang: n,
+      serverId: s,
+      serverOrigin: o,
+      serverSource: a,
+      theme: i
+    } = t, c = {
+      id: s,
+      origin: o,
+      source: a
+    }, l = new ee({
       transportId: r
     });
-    c.addPeer(i), this.rpcClient = new K({
-      transport: c,
-      serverId: n
-    }), this.subscriber = new G({
-      transport: c,
-      brokerId: i.id
-    }), document.documentElement.dataset.theme = a, this.crashReporter = new me((h) => {
-      this.makeRequest("v1.system.report.crash", h);
+    l.addPeer(c), this.rpcClient = new Z({
+      transport: l,
+      serverId: s
+    }), this.subscriber = new z({
+      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) {
@@ -636,26 +638,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))
@@ -663,7 +665,7 @@ function ve(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")
@@ -679,34 +681,37 @@ const l = () => {
       });
     } catch {
     }
-}, Se = () => {
-  u(Window.prototype, "open", () => null), u(window, "open", () => null), u(Element.prototype, "scrollIntoView", l), u(
+}, Ne = () => {
+  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", 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", 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 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 ge({
+  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(), H = !0, s;
+  return o.bootstrap(), k = !0, o;
 };
 export {
-  Ne as createExtHelper
+  ke as createExtHelper,
+  He as isExtensionError
 };

package/dist/helpers/index.d.ts

@@ -829,6 +829,10 @@ declare type TV1StorageMethods = {
             /** 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: {
@@ -871,6 +875,10 @@ declare type TV1StorageMethods = {
             /** 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: {

package/dist/helpers/react.d.ts

@@ -763,6 +763,10 @@ declare type TV1StorageMethods = {
             /** 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: {
@@ -805,6 +809,10 @@ declare type TV1StorageMethods = {
             /** 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: {

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']>;
@@ -51,6 +57,7 @@ declare type TExtHelper = {
 
 declare type TExtHelperProps = {
     frameId: string;
+    lang: string;
     serverId: string;
     serverOrigin: string;
     serverSource: Window;
@@ -196,6 +203,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;
@@ -458,6 +471,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 = {
@@ -799,6 +817,10 @@ declare type TV1StorageMethods = {
             /** 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: {
@@ -841,6 +863,10 @@ declare type TV1StorageMethods = {
             /** 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: {
@@ -903,6 +929,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: {

package/package.json

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