@cloudparse/up-miniapps-sdk 0.5.6 → 0.6.0

package/dist/index.cjs

@@ -50,6 +50,7 @@ __export(src_exports, {
   SDKProvider: () => SDKProvider,
   SwipeCarousel: () => SwipeCarousel,
   UIEvent: () => UIEvent,
+  createApiService: () => createApiService,
   default: () => src_default,
   handleClearRoute: () => handleClearRoute,
   handleDrawRoute: () => handleDrawRoute,
@@ -125,6 +126,8 @@ var Button = React.forwardRef(
 Button.displayName = "Button";
 
 // src/bridge.ts
+var BridgeTimeoutError = class extends Error {
+};
 var Bridge = class {
   callbacks = /* @__PURE__ */ new Map();
   eventListeners = /* @__PURE__ */ new Map();
@@ -195,18 +198,32 @@ var Bridge = class {
    * @param type The action type (e.g., "GET_LOCATION").
    * @param payload Data associated with the action.
    * @param timeoutMs Time in milliseconds to wait for a response before rejecting.
+   * @param retries Number of additional attempts if a request times out (default 1 — one retry).
+   *   Exists because the response for a request can be lost in transit — e.g. the host's
+   *   injected response script running before this WebView's own `message` listener has
+   *   attached, worse under rapid mount/unmount cycles — with no application-visible symptom
+   *   other than the full 30s timeout. A blind retry self-heals that class of loss without
+   *   needing to diagnose which specific transport race dropped the original message; every
+   *   call site benefits automatically instead of each consumer app hand-rolling its own
+   *   retry-after-catch logic (which previously only covered `initialize()`, and imperfectly).
    * @returns A promise that resolves with the native response.
    */
-  send(type, payload, timeoutMs = 3e4) {
+  send(type, payload, timeoutMs = 3e4, retries = 1) {
     if (!this.isNative()) {
       return this.handleMockMessage(type, payload);
     }
+    return this.sendOnce(type, payload, timeoutMs).catch((err) => {
+      if (retries <= 0 || !(err instanceof BridgeTimeoutError)) throw err;
+      return this.send(type, payload, timeoutMs, retries - 1);
+    });
+  }
+  sendOnce(type, payload, timeoutMs) {
     return new Promise((resolve, reject) => {
       const callbackId = `${type}_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
       const timeout = setTimeout(() => {
         if (this.callbacks.has(callbackId)) {
           this.callbacks.delete(callbackId);
-          reject(new Error(`Bridge request timeout: ${type}`));
+          reject(new BridgeTimeoutError(`Bridge request timeout: ${type}`));
         }
       }, timeoutMs);
       this.callbacks.set(callbackId, {
@@ -3680,7 +3697,7 @@ var RoutingService = {
 };
 
 // package.json
-var version = "0.5.6";
+var version = "0.6.0";
 
 // src/sdk.ts
 function deepFreeze(obj) {
@@ -3695,6 +3712,7 @@ function deepFreeze(obj) {
   return Object.freeze(obj);
 }
 var globalRoutingConfig = null;
+var lastKnownEnv = null;
 var MiniAppSDK = class {
   /**
    * Map services.
@@ -4017,7 +4035,14 @@ var MiniAppSDK = class {
   });
   constructor() {
     this.bridge = new Bridge();
+    this.bridge.on(
+      "UPDATE_CONTEXT" /* UPDATE_CONTEXT */,
+      (data) => {
+        if (data?.env) lastKnownEnv = data.env;
+      }
+    );
     this.initialize = this.initialize.bind(this);
+    this.getEnv = this.getEnv.bind(this);
     this.on = this.on.bind(this);
     this.off = this.off.bind(this);
   }
@@ -4041,8 +4066,22 @@ var MiniAppSDK = class {
    * The starting point for the Mini-App. Must be called before any other SDK methods.
    * @param options The options to provide to the shell app
    */
-  initialize(options) {
-    return this.bridge.send("INITIALIZE", options);
+  async initialize(options) {
+    const res = await this.bridge.send(
+      "INITIALIZE",
+      options
+    );
+    if (res?.env) lastKnownEnv = res.env;
+    return res;
+  }
+  /**
+   * Returns the last known `env` (shell-provided config like `backendUrl`),
+   * refreshed automatically by `initialize()` and every `UPDATE_CONTEXT`
+   * push — read this instead of caching your own copy of `env` values.
+   * Returns `null` before the first successful `initialize()`/context push.
+   */
+  getEnv() {
+    return lastKnownEnv;
   }
   /**
    * Registers a callback for a specific event from the native shell.
@@ -5249,6 +5288,72 @@ function handleClearRoute(map, miniAppId) {
   if (map.getSource(sourceId)) map.removeSource(sourceId);
 }
 
+// src/services/apiService.ts
+function buildUrl(baseUrl, path) {
+  if (path.startsWith("http://") || path.startsWith("https://")) {
+    return path;
+  }
+  let cleanBase = baseUrl.trim();
+  while (cleanBase.endsWith("/")) {
+    cleanBase = cleanBase.slice(0, -1);
+  }
+  let cleanPath = path.trim();
+  if (!cleanPath.startsWith("/")) {
+    cleanPath = `/${cleanPath}`;
+  }
+  const baseEndsWithV1 = cleanBase.endsWith("/api/v1");
+  const pathStartsWithV1 = cleanPath.startsWith("/api/v1/") || cleanPath === "/api/v1";
+  if (baseEndsWithV1 && pathStartsWithV1) {
+    const strippedPath = cleanPath.slice(7);
+    return `${cleanBase}${strippedPath}`;
+  }
+  return `${cleanBase}${cleanPath}`;
+}
+function getEarlyBackendUrl(kind) {
+  if (typeof window === "undefined") return void 0;
+  const early = window.__UP_BACKEND_URLS__;
+  return early?.[kind] ?? void 0;
+}
+function createApiService(options) {
+  const getBaseUrl = () => getEarlyBackendUrl("http") || sdk.getEnv()?.backendUrl || options.defaultBaseUrl;
+  const getWsUrl = () => getEarlyBackendUrl("ws") || sdk.getEnv()?.wsBackendUrl || options.defaultWsBackendUrl;
+  return {
+    get baseUrl() {
+      return getBaseUrl();
+    },
+    delete: (path) => sdk.network.request({
+      method: "DELETE",
+      url: buildUrl(getBaseUrl(), path)
+    }),
+    get: (path) => sdk.network.request({
+      headers: { "Content-Type": "application/json" },
+      method: "GET",
+      url: buildUrl(getBaseUrl(), path)
+    }),
+    graphqlQuery: (query, variables = {}) => sdk.network.request({
+      body: { query, variables },
+      headers: { "Content-Type": "application/json" },
+      method: "POST",
+      url: buildUrl(getBaseUrl(), "/graphql")
+    }),
+    patch: (path, body) => sdk.network.request({
+      body,
+      headers: { "Content-Type": "application/json" },
+      method: "PATCH",
+      url: buildUrl(getBaseUrl(), path)
+    }),
+    post: (path, body) => sdk.network.request({
+      body,
+      headers: { "Content-Type": "application/json" },
+      method: "POST",
+      url: buildUrl(getBaseUrl(), path)
+    }),
+    get wsUrl() {
+      return getWsUrl();
+    }
+  };
+}
+
 // src/index.ts
 var src_default = sdk;
 // Annotate the CommonJS export names for ESM import in node:
@@ -5273,6 +5378,7 @@ var src_default = sdk;
   SDKProvider,
   SwipeCarousel,
   UIEvent,
+  createApiService,
   handleClearRoute,
   handleDrawRoute,
   handleRouteRequest,