@cloudparse/up-miniapps-sdk 0.1.6 → 0.2.0

package/dist/index.mjs

@@ -1,348 +0,0 @@
-// src/bridge.ts
-var Bridge = class {
-  callbacks = /* @__PURE__ */ new Map();
-  eventListeners = /* @__PURE__ */ new Map();
-  /**
-   * Registers a global listener for messages coming from the native shell.
-   * Also listens for standard browser `message` events to support multiple
-   * communication channels (e.g., React Native WebView postMessage).
-   */
-  constructor() {
-    if (typeof window !== "undefined") {
-      const bridgeReceiver = Object.freeze({
-        onNativeMessage: (envelope) => this.handleNativeMessage(envelope)
-      });
-      Object.defineProperty(window, "__MiniAppBridge", {
-        configurable: false,
-        value: bridgeReceiver,
-        writable: false
-      });
-      window.addEventListener("message", (event) => {
-        if (!event.data) return;
-        try {
-          const data = typeof event.data === "string" ? JSON.parse(event.data) : event.data;
-          if (data && typeof data === "object" && (data.callbackId || data.event)) {
-            this.handleNativeMessage(data);
-          }
-        } catch (_e) {
-        }
-      });
-    }
-  }
-  /**
-   * Subscribes to a pushed event from the native shell.
-   *
-   * @param event The event name to listen for.
-   * @param callback Function to execute when the event occurs.
-   * @returns An unsubscription function.
-   */
-  on(event, callback) {
-    let listeners = this.eventListeners.get(event);
-    if (!listeners) {
-      listeners = [];
-      this.eventListeners.set(event, listeners);
-    }
-    listeners.push(callback);
-    return () => this.off(event, callback);
-  }
-  /**
-   * Unsubscribes a specific callback from an event.
-   *
-   * @param event The event name.
-   * @param callback The callback function to remove.
-   */
-  off(event, callback) {
-    const listeners = this.eventListeners.get(event);
-    if (!listeners) return;
-    this.eventListeners.set(
-      event,
-      listeners.filter((cb) => cb !== callback)
-    );
-  }
-  /**
-   * Sends a message to the native shell and waits for a response.
-   *
-   * @template T The expected response type.
-   * @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.
-   * @returns A promise that resolves with the native response.
-   */
-  send(type, payload, timeoutMs = 3e4) {
-    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}`));
-        }
-      }, timeoutMs);
-      this.callbacks.set(callbackId, {
-        reject,
-        resolve,
-        timeout
-      });
-      const message = {
-        callbackId,
-        payload,
-        type
-      };
-      const win = window;
-      if (win.ReactNativeWebView?.postMessage) {
-        win.ReactNativeWebView.postMessage(JSON.stringify(message));
-      } else {
-        clearTimeout(timeout);
-        this.callbacks.delete(callbackId);
-        reject(new Error("Bridge not available"));
-      }
-    });
-  }
-  /**
-   * Internal handler for all incoming messages from the native shell.
-   * Matches incoming payloads to either pending callbacks or event listeners.
-   *
-   * @internal
-   * @param envelope The message envelope received from native code.
-   */
-  handleNativeMessage(envelope) {
-    if (!envelope || typeof envelope !== "object") return;
-    const callbackId = envelope.callbackId;
-    if (callbackId && typeof callbackId === "string") {
-      const callback = this.callbacks.get(callbackId);
-      if (callback) {
-        clearTimeout(callback.timeout);
-        const { resolve, reject } = callback;
-        if (envelope.success === false || envelope.error) {
-          reject(envelope.error || "Unknown error");
-        } else {
-          resolve(envelope.value ?? envelope.payload ?? envelope);
-        }
-        this.callbacks.delete(callbackId);
-        return;
-      }
-    }
-    const eventName = envelope.event;
-    if (eventName && typeof eventName === "string") {
-      const listeners = this.eventListeners.get(eventName);
-      if (listeners) {
-        for (const listener of listeners) {
-          try {
-            listener(envelope.payload || envelope.value);
-          } catch (e) {
-            console.error(`Error in event listener for ${eventName}:`, e);
-          }
-        }
-      }
-    }
-  }
-};
-
-// src/sdk.ts
-function deepFreeze(obj) {
-  const propNames = Object.getOwnPropertyNames(obj);
-  for (const name of propNames) {
-    const value = obj[name];
-    if (value && typeof value === "object" && !Object.isFrozen(value) && // Skip freezing of native objects or circular refs if any (though not expected here)
-    !(value instanceof Bridge)) {
-      deepFreeze(value);
-    }
-  }
-  return Object.freeze(obj);
-}
-var MiniAppSDK = class {
-  bridge;
-  /**
-   * Local SQLite Storage.
-   * Data is persisted on the device and is isolated per Mini-App.
-   */
-  storage = Object.freeze({
-    /** Retrieves a value by key. */
-    get: (key) => this.bridge.send("STORAGE_GET", { key }),
-    /** Retrieves all key-value pairs stored for this Mini-App. */
-    getAll: () => this.bridge.send("STORAGE_GET_ALL"),
-    /** Sets a value for a specific key. */
-    set: (key, value) => this.bridge.send("STORAGE_SET", { key, value })
-  });
-  /**
-   * Hardware-level Secure Storage.
-   * Data is stored in the device's secure enclave (Keychain/Keystore) and is isolated per Mini-App.
-   */
-  secureStore = Object.freeze({
-    /** Retrieves a value by key from secure storage. */
-    get: (key) => this.bridge.send("SECURE_GET", { key }),
-    /** Sets a value for a specific key in secure storage. */
-    set: (key, value) => this.bridge.send("SECURE_SET", { key, value })
-  });
-  /**
-   * Database Storage.
-   * Access to user-app specific persistent database storage.
-   */
-  database = Object.freeze({
-    /** Retrieves the user data stored in the backend database. */
-    getUserData: () => this.bridge.send("DATABASE_GET_USER_DATA"),
-    /** Updates the user data stored in the backend database. */
-    setUserData: (data) => this.bridge.send("DATABASE_SET_USER_DATA", { data })
-  });
-  /**
-   * Device Location services.
-   */
-  location = Object.freeze({
-    /** Retrieves the current GPS position of the device. */
-    getCurrentPosition: () => this.bridge.send("GET_LOCATION")
-  });
-  /**
-   * Identity & Profile management.
-   */
-  user = Object.freeze({
-    /**
-     * Fetch user profile data.
-     * @param fields Optional list of specific fields to retrieve (e.g., ['fullName', 'username']).
-     */
-    getProfile: (fields) => this.bridge.send("GET_USER_PROFILE", { fields })
-  });
-  /**
-   * Explicit Permission Management.
-   * Allows requesting access to sensitive device features or user data.
-   */
-  permission = Object.freeze({
-    /**
-     * Explicitly request access to sensitive data.
-     * @param type The type of permission to request ('location' or 'profile').
-     * @param fields If requesting 'profile', the specific fields required.
-     */
-    request: ((type, fields) => {
-      return this.bridge.send("REQUEST_PERMISSION", { fields, type });
-    })
-  });
-  /**
-   * Payments integration.
-   */
-  payment = Object.freeze({
-    /**
-     * Triggers the native payment flow.
-     * @param payload Amount, currency, and itemized list for the payment.
-     */
-    request: (payload) => this.bridge.send("PAYMENT_REQUEST", payload)
-  });
-  /**
-   * Live Activities & Notifications.
-   * Allows the Mini-App to display real-time updates in the host shell.
-   */
-  activity = Object.freeze({
-    /**
-     * Starts a new live activity.
-     * @param id Unique identifier for the activity.
-     * @param title Display title for the activity.
-     * @param status Initial status message.
-     */
-    start: (id, title, status) => this.bridge.send("START_ACTIVITY", { id, status, title })
-  });
-  /**
-   * Haptic feedback.
-   */
-  haptic = Object.freeze({
-    /**
-     * Triggers a haptic vibration on the device.
-     * @param style The style of haptic feedback (e.g., 'light', 'medium', 'heavy', 'success', 'warning', 'error').
-     */
-    trigger: (style) => this.bridge.send("TRIGGER_HAPTIC", { style })
-  });
-  /**
-   * Network Proxy.
-   * Allows the Mini-App to make network requests through the host shell to bypass CORS or use host-level authentication.
-   */
-  network = Object.freeze({
-    /**
-     * Performs a network request via the host shell.
-     * @param options Request method, URL, headers, and body.
-     */
-    request: (options) => this.bridge.send("NETWORK_REQUEST", options)
-  });
-  /**
-   * Fidelity & Rewards program integration.
-   */
-  fidelity = Object.freeze({
-    /** Returns current fidelity balance. */
-    getFidelityBalance: () => this.bridge.send("GET_FIDELITY_BALANCE"),
-    /**
-     * Retrieves fidelity transaction history.
-     * @param params Filtering and pagination parameters.
-     */
-    getFidelityHistory: (params) => this.bridge.send("GET_FIDELITY_HISTORY", params),
-    /**
-     * Authorize spending fidelity points (FPoints) via Two-Phase Authorization.
-     * @param intentUuid UUID generated by your backend for the transaction.
-     */
-    spendFPoints: (intentUuid) => this.bridge.send("SPEND_FPOINTS", { intentUuid })
-  });
-  /**
-   * UI and Navigation controls.
-   */
-  ui = Object.freeze({
-    /** Closes the Mini-App and returns to the host shell. */
-    exit: () => this.bridge.send("EXIT"),
-    /**
-     * Configures native scroll behaviors like Pull-to-Refresh and Infinite Scroll.
-     * @param config Scroll configuration for top/bottom detection.
-     */
-    setScrollConfig: (config) => this.bridge.send("SET_SCROLL_CONFIG", config)
-  });
-  /**
-   * Debug controls
-   */
-  debug = Object.freeze({
-    /**
-     * Log to the shell app
-     * @param message
-     */
-    log: (...message) => this.bridge.send("DEBUG_LOG", { message })
-  });
-  constructor() {
-    this.bridge = new Bridge();
-    this.initialize = this.initialize.bind(this);
-    this.on = this.on.bind(this);
-    this.off = this.off.bind(this);
-  }
-  /**
-   * 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);
-  }
-  /**
-   * Registers a callback for a specific event from the native shell.
-   * @param event The name of the event to listen for.
-   * @param callback The function to execute when the event is triggered.
-   * @returns A function to unregister the listener.
-   */
-  on(event, callback) {
-    return this.bridge.on(event, callback);
-  }
-  /**
-   * Unregisters a previously registered event listener.
-   * @param event The name of the event.
-   * @param callback The callback function to remove.
-   */
-  off(event, callback) {
-    this.bridge.off(event, callback);
-  }
-};
-var sdk = deepFreeze(new MiniAppSDK());
-
-// src/types/types.ts
-var UIEvent = /* @__PURE__ */ ((UIEvent2) => {
-  UIEvent2["TOP_SCROLL_MORE"] = "TOP_SCROLL_MORE";
-  UIEvent2["BOTTOM_SCROLL_MORE"] = "BOTTOM_SCROLL_MORE";
-  return UIEvent2;
-})(UIEvent || {});
-
-// src/index.ts
-var index_default = sdk;
-export {
-  MiniAppSDK,
-  UIEvent,
-  index_default as default,
-  sdk
-};
-//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/bridge.ts","../src/sdk.ts","../src/types/types.ts","../src/index.ts"],"sourcesContent":["import type { IBridgeEnvelope } from \"@miniapps-sdk/types\";\n\n/**\n * The Bridge handles low-level communication between the Mini-App WebView\n * and the Native Host Shell (iOS/Android).\n *\n * It manages asynchronous request-response cycles via callbacks and\n * supports subscription to pushed events from the native environment.\n */\nexport class Bridge {\n  private callbacks = new Map<\n    string,\n    {\n      resolve: (val: unknown) => void;\n      reject: (err: unknown) => void;\n      timeout: ReturnType<typeof setTimeout>;\n    }\n  >();\n  private eventListeners = new Map<string, ((data: unknown) => void)[]>();\n\n  /**\n   * Registers a global listener for messages coming from the native shell.\n   * Also listens for standard browser `message` events to support multiple\n   * communication channels (e.g., React Native WebView postMessage).\n   */\n  constructor() {\n    if (typeof window !== \"undefined\") {\n      const bridgeReceiver = Object.freeze({\n        onNativeMessage: (envelope: IBridgeEnvelope) =>\n          this.handleNativeMessage(envelope),\n      });\n\n      // Use defineProperty to prevent re-assignment or deletion of the bridge\n      Object.defineProperty(window, \"__MiniAppBridge\", {\n        configurable: false,\n        value: bridgeReceiver,\n        writable: false,\n      });\n\n      window.addEventListener(\"message\", (event) => {\n        // SECURITY: Filter events. If inside a mobile shell, the origin of native postMessage\n        // varies by platform (e.g., file://, or specific app schemes).\n        // For production, this should be restricted to the expected host origin.\n        if (!event.data) return;\n\n        try {\n          const data =\n            typeof event.data === \"string\"\n              ? JSON.parse(event.data)\n              : event.data;\n\n          // SECURITY: Basic envelope validation\n          if (\n            data &&\n            typeof data === \"object\" &&\n            (data.callbackId || data.event)\n          ) {\n            this.handleNativeMessage(data);\n          }\n        } catch (_e) {\n          // Ignore non-JSON or malformed messages\n        }\n      });\n    }\n  }\n\n  /**\n   * Subscribes to a pushed event from the native shell.\n   *\n   * @param event The event name to listen for.\n   * @param callback Function to execute when the event occurs.\n   * @returns An unsubscription function.\n   */\n  public on(event: string, callback: (data: unknown) => void) {\n    let listeners = this.eventListeners.get(event);\n    if (!listeners) {\n      listeners = [];\n      this.eventListeners.set(event, listeners);\n    }\n    listeners.push(callback);\n    return () => this.off(event, callback);\n  }\n\n  /**\n   * Unsubscribes a specific callback from an event.\n   *\n   * @param event The event name.\n   * @param callback The callback function to remove.\n   */\n  public off(event: string, callback: (data: unknown) => void) {\n    const listeners = this.eventListeners.get(event);\n    if (!listeners) return;\n    this.eventListeners.set(\n      event,\n      listeners.filter((cb) => cb !== callback),\n    );\n  }\n\n  /**\n   * Sends a message to the native shell and waits for a response.\n   *\n   * @template T The expected response type.\n   * @param type The action type (e.g., \"GET_LOCATION\").\n   * @param payload Data associated with the action.\n   * @param timeoutMs Time in milliseconds to wait for a response before rejecting.\n   * @returns A promise that resolves with the native response.\n   */\n  public send<T = unknown>(\n    type: string,\n    payload?: unknown,\n    timeoutMs = 30000,\n  ): Promise<T> {\n    return new Promise((resolve, reject) => {\n      const callbackId = `${type}_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;\n\n      const timeout = setTimeout(() => {\n        if (this.callbacks.has(callbackId)) {\n          this.callbacks.delete(callbackId);\n          reject(new Error(`Bridge request timeout: ${type}`));\n        }\n      }, timeoutMs);\n\n      this.callbacks.set(callbackId, {\n        reject,\n        resolve: resolve as (val: unknown) => void,\n        timeout,\n      });\n\n      const message = {\n        callbackId,\n        payload,\n        type,\n      };\n\n      const win = window as unknown as {\n        ReactNativeWebView?: { postMessage: (msg: string) => void };\n      };\n\n      if (win.ReactNativeWebView?.postMessage) {\n        win.ReactNativeWebView.postMessage(JSON.stringify(message));\n      } else {\n        clearTimeout(timeout);\n        this.callbacks.delete(callbackId);\n        reject(new Error(\"Bridge not available\"));\n      }\n    });\n  }\n\n  /**\n   * Internal handler for all incoming messages from the native shell.\n   * Matches incoming payloads to either pending callbacks or event listeners.\n   *\n   * @internal\n   * @param envelope The message envelope received from native code.\n   */\n  private handleNativeMessage(envelope: IBridgeEnvelope) {\n    if (!envelope || typeof envelope !== \"object\") return;\n\n    // 1. Handle Response Callbacks\n    const callbackId = envelope.callbackId;\n    if (callbackId && typeof callbackId === \"string\") {\n      const callback = this.callbacks.get(callbackId);\n      if (callback) {\n        clearTimeout(callback.timeout);\n        const { resolve, reject } = callback;\n\n        if (envelope.success === false || envelope.error) {\n          reject(envelope.error || \"Unknown error\");\n        } else {\n          resolve(envelope.value ?? envelope.payload ?? envelope);\n        }\n\n        this.callbacks.delete(callbackId);\n        return;\n      }\n    }\n\n    // 2. Handle Pushed Events\n    const eventName = envelope.event;\n    if (eventName && typeof eventName === \"string\") {\n      const listeners = this.eventListeners.get(eventName);\n      if (listeners) {\n        for (const listener of listeners) {\n          try {\n            listener(envelope.payload || envelope.value);\n          } catch (e) {\n            console.error(`Error in event listener for ${eventName}:`, e);\n          }\n        }\n      }\n    }\n  }\n}\n","import { Bridge } from \"@miniapps-sdk/bridge\";\nimport type {\n  HapticStyleType,\n  IFidelityBalance,\n  IFidelityHistoryParams,\n  IFidelityTransaction,\n  IInitializationOptions,\n  IInitializationResponse,\n  ILocationData,\n  INetworkOptions,\n  INetworkResponse,\n  IPaymentRequest,\n  IUserProfile,\n  ScrollConfig,\n  SDKEvent,\n} from \"@miniapps-sdk/types/types\";\n\n/**\n * Deep freezes an object and its nested properties.\n * @param obj The object to freeze.\n * @returns The frozen object.\n */\nfunction deepFreeze<T extends object>(obj: T): T {\n  // Retrieve the property names defined on obj\n  const propNames = Object.getOwnPropertyNames(obj);\n\n  // Freeze properties before freezing self\n  for (const name of propNames) {\n    const value = (obj as Record<string, unknown>)[name];\n\n    if (\n      value &&\n      typeof value === \"object\" &&\n      !Object.isFrozen(value) &&\n      // Skip freezing of native objects or circular refs if any (though not expected here)\n      !(value instanceof Bridge)\n    ) {\n      deepFreeze(value as object);\n    }\n  }\n\n  return Object.freeze(obj);\n}\n\n/**\n * Main SDK for UP Mini-Apps.\n * Provides access to native device features, storage, identity, and shell UI.\n */\nexport class MiniAppSDK {\n  private bridge: Bridge;\n  /**\n   * Local SQLite Storage.\n   * Data is persisted on the device and is isolated per Mini-App.\n   */\n  public readonly storage = Object.freeze({\n    /** Retrieves a value by key. */\n    get: (key: string): Promise<string | null> =>\n      this.bridge.send(\"STORAGE_GET\", { key }),\n    /** Retrieves all key-value pairs stored for this Mini-App. */\n    getAll: (): Promise<Record<string, string>> =>\n      this.bridge.send(\"STORAGE_GET_ALL\"),\n    /** Sets a value for a specific key. */\n    set: (key: string, value: string): Promise<void> =>\n      this.bridge.send(\"STORAGE_SET\", { key, value }),\n  });\n  /**\n   * Hardware-level Secure Storage.\n   * Data is stored in the device's secure enclave (Keychain/Keystore) and is isolated per Mini-App.\n   */\n  public readonly secureStore = Object.freeze({\n    /** Retrieves a value by key from secure storage. */\n    get: (key: string): Promise<string | null> =>\n      this.bridge.send(\"SECURE_GET\", { key }),\n    /** Sets a value for a specific key in secure storage. */\n    set: (key: string, value: string): Promise<void> =>\n      this.bridge.send(\"SECURE_SET\", { key, value }),\n  });\n  /**\n   * Database Storage.\n   * Access to user-app specific persistent database storage.\n   */\n  public readonly database = Object.freeze({\n    /** Retrieves the user data stored in the backend database. */\n    getUserData: <T = unknown>(): Promise<T> =>\n      this.bridge.send<T>(\"DATABASE_GET_USER_DATA\"),\n    /** Updates the user data stored in the backend database. */\n    setUserData: <T = unknown>(data: T): Promise<void> =>\n      this.bridge.send<void>(\"DATABASE_SET_USER_DATA\", { data }),\n  });\n  /**\n   * Device Location services.\n   */\n  public readonly location = Object.freeze({\n    /** Retrieves the current GPS position of the device. */\n    getCurrentPosition: (): Promise<ILocationData> =>\n      this.bridge.send(\"GET_LOCATION\"),\n  });\n  /**\n   * Identity & Profile management.\n   */\n  public readonly user = Object.freeze({\n    /**\n     * Fetch user profile data.\n     * @param fields Optional list of specific fields to retrieve (e.g., ['fullName', 'username']).\n     */\n    getProfile: <T extends keyof IUserProfile>(\n      fields?: T[],\n    ): Promise<Partial<IUserProfile>> =>\n      this.bridge.send(\"GET_USER_PROFILE\", { fields }),\n  });\n  /**\n   * Explicit Permission Management.\n   * Allows requesting access to sensitive device features or user data.\n   */\n  public readonly permission = Object.freeze({\n    /**\n     * Explicitly request access to sensitive data.\n     * @param type The type of permission to request ('location' or 'profile').\n     * @param fields If requesting 'profile', the specific fields required.\n     */\n    request: ((type: \"location\" | \"profile\", fields?: string[]) => {\n      return this.bridge.send(\"REQUEST_PERMISSION\", { fields, type });\n    }) as {\n      (type: \"location\"): Promise<boolean>;\n      (type: \"profile\", fields: (keyof IUserProfile)[]): Promise<boolean>;\n    },\n  });\n  /**\n   * Payments integration.\n   */\n  public readonly payment = Object.freeze({\n    /**\n     * Triggers the native payment flow.\n     * @param payload Amount, currency, and itemized list for the payment.\n     */\n    request: (\n      payload: IPaymentRequest,\n    ): Promise<{ success: true; transactionId: string }> =>\n      this.bridge.send(\"PAYMENT_REQUEST\", payload),\n  });\n  /**\n   * Live Activities & Notifications.\n   * Allows the Mini-App to display real-time updates in the host shell.\n   */\n  public readonly activity = Object.freeze({\n    /**\n     * Starts a new live activity.\n     * @param id Unique identifier for the activity.\n     * @param title Display title for the activity.\n     * @param status Initial status message.\n     */\n    start: (id: string, title: string, status: string): Promise<void> =>\n      this.bridge.send(\"START_ACTIVITY\", { id, status, title }),\n  });\n  /**\n   * Haptic feedback.\n   */\n  public readonly haptic = Object.freeze({\n    /**\n     * Triggers a haptic vibration on the device.\n     * @param style The style of haptic feedback (e.g., 'light', 'medium', 'heavy', 'success', 'warning', 'error').\n     */\n    trigger: (style: HapticStyleType): Promise<void> =>\n      this.bridge.send(\"TRIGGER_HAPTIC\", { style }),\n  });\n  /**\n   * Network Proxy.\n   * Allows the Mini-App to make network requests through the host shell to bypass CORS or use host-level authentication.\n   */\n  public readonly network = Object.freeze({\n    /**\n     * Performs a network request via the host shell.\n     * @param options Request method, URL, headers, and body.\n     */\n    request: (options: INetworkOptions): Promise<INetworkResponse> =>\n      this.bridge.send(\"NETWORK_REQUEST\", options),\n  });\n  /**\n   * Fidelity & Rewards program integration.\n   */\n  public readonly fidelity = Object.freeze({\n    /** Returns current fidelity balance. */\n    getFidelityBalance: (): Promise<IFidelityBalance> =>\n      this.bridge.send(\"GET_FIDELITY_BALANCE\"),\n    /**\n     * Retrieves fidelity transaction history.\n     * @param params Filtering and pagination parameters.\n     */\n    getFidelityHistory: (\n      params?: IFidelityHistoryParams,\n    ): Promise<IFidelityTransaction[]> =>\n      this.bridge.send(\"GET_FIDELITY_HISTORY\", params),\n    /**\n     * Authorize spending fidelity points (FPoints) via Two-Phase Authorization.\n     * @param intentUuid UUID generated by your backend for the transaction.\n     */\n    spendFPoints: (\n      intentUuid: string,\n    ): Promise<{ success: boolean; transactionId: string }> =>\n      this.bridge.send(\"SPEND_FPOINTS\", { intentUuid }),\n  });\n  /**\n   * UI and Navigation controls.\n   */\n  public readonly ui = Object.freeze({\n    /** Closes the Mini-App and returns to the host shell. */\n    exit: (): Promise<void> => this.bridge.send(\"EXIT\"),\n    /**\n     * Configures native scroll behaviors like Pull-to-Refresh and Infinite Scroll.\n     * @param config Scroll configuration for top/bottom detection.\n     */\n    setScrollConfig: (config: ScrollConfig): Promise<void> =>\n      this.bridge.send(\"SET_SCROLL_CONFIG\", config),\n  });\n  /**\n   * Debug controls\n   */\n  public readonly debug = Object.freeze({\n    /**\n     * Log to the shell app\n     * @param message\n     */\n    log: (...message: unknown[]) => this.bridge.send(\"DEBUG_LOG\", { message }),\n  });\n\n  constructor() {\n    this.bridge = new Bridge();\n\n    // Bind methods to this instance to preserve context if pulled out\n    this.initialize = this.initialize.bind(this);\n    this.on = this.on.bind(this);\n    this.off = this.off.bind(this);\n  }\n\n  /**\n   * The starting point for the Mini-App. Must be called before any other SDK methods.\n   * @param options The options to provide to the shell app\n   */\n  public initialize(\n    options: IInitializationOptions,\n  ): Promise<IInitializationResponse> {\n    return this.bridge.send(\"INITIALIZE\", options);\n  }\n\n  /**\n   * Registers a callback for a specific event from the native shell.\n   * @param event The name of the event to listen for.\n   * @param callback The function to execute when the event is triggered.\n   * @returns A function to unregister the listener.\n   */\n  public on(event: SDKEvent, callback: (data: unknown) => void) {\n    return this.bridge.on(event as string, callback);\n  }\n\n  /**\n   * Unregisters a previously registered event listener.\n   * @param event The name of the event.\n   * @param callback The callback function to remove.\n   */\n  public off(event: SDKEvent, callback: (data: unknown) => void) {\n    this.bridge.off(event as string, callback);\n  }\n}\n\n/**\n * Singleton instance of the MiniAppSDK.\n * Frozen to prevent tampering.\n */\nexport const sdk = deepFreeze(new MiniAppSDK());\n","/**\n * UP Mini-App SDK Types\n */\n\n/**\n * Represents the user's profile information.\n */\nexport interface IUserProfile {\n  /** Unique identifier for the user. */\n  uuid: string;\n  /** Full legal name of the user. */\n  fullName: string;\n  /** Primary email address. */\n  email: string;\n  /** Chosen username within the UP ecosystem. */\n  username: string;\n  /** ISO country code (e.g., \"FR\", \"US\"). */\n  countryCode: string;\n  /** Phone number without country code. */\n  localNumber: string;\n}\n\n/**\n * Geographic location data.\n */\nexport interface ILocationData {\n  coords: {\n    /** Latitude in decimal degrees. */\n    latitude: number;\n    /** Longitude in decimal degrees. */\n    longitude: number;\n    /** Altitude in meters above the WGS 84 reference ellipsoid, or null if not available. */\n    altitude: number | null;\n    /** Accuracy of the latitude and longitude properties in meters. */\n    accuracy: number | null;\n    /** Accuracy of the altitude property in meters. */\n    altitudeAccuracy: number | null;\n    /** The direction in which the device is traveling, in degrees (0-360). */\n    heading: number | null;\n    /** The velocity of the device in meters per second. */\n    speed: number | null;\n  };\n  /** The time at which the location was retrieved (Unix timestamp). */\n  timestamp: number;\n}\n\n/**\n * Request payload for triggering a payment flow.\n */\nexport interface IPaymentRequest {\n  /** The specific amount to charge. */\n  amount: number;\n  /** ISO currency code (e.g., \"EUR\", \"USD\"). */\n  currency: string;\n  /** Total amount including taxes/fees. */\n  total: number;\n  /** Itemized breakdown of the purchase. */\n  items: Array<{\n    /** Name or description of the item. */\n    item: string;\n    /** Price per unit. */\n    price?: number;\n    /** Number of units. */\n    quantity?: number;\n  }>;\n}\n\n/**\n * Style of haptic feedback.\n */\nexport type HapticStyleType =\n  | \"light\"\n  | \"medium\"\n  | \"heavy\"\n  | \"rigid\"\n  | \"soft\"\n  | \"success\"\n  | \"warning\"\n  | \"error\";\n\n/**\n * Network Proxy Types\n */\n\n/**\n * The HTTP method to use as request method\n */\nexport type NetworkMethodType = \"GET\" | \"POST\" | \"PUT\" | \"DELETE\" | \"PATCH\";\n\n/**\n * Configuration for network proxy requests.\n */\nexport interface INetworkOptions {\n  /** Full URL for the request. */\n  url: string;\n  /** HTTP method to use. */\n  method: NetworkMethodType;\n  /** Request body for POST/PUT/PATCH. */\n  body?: unknown;\n  /** Custom HTTP headers. */\n  headers?: Record<string, string>;\n}\n\n/**\n * Response from a network proxy request.\n */\nexport interface INetworkResponse<T = unknown> {\n  /** HTTP status code. */\n  status: number;\n  /** Response data payload. */\n  data: T;\n  /** Response headers. */\n  headers: Headers;\n}\n\n/**\n * Fidelity & Rewards Types\n */\n\n/**\n * Fidelity program balance information.\n */\nexport interface IFidelityBalance {\n  /** Current point or currency balance. */\n  balance: number;\n  /** Name or symbol of the fidelity currency (e.g., \"FPoints\"). */\n  currency: string;\n}\n\n/**\n * Parameters for retrieving fidelity transaction history.\n */\nexport interface IFidelityHistoryParams {\n  /** Maximum number of records to return. */\n  limit?: number;\n\n  /** Cursor for pagination; null for the first page. */\n  cursor?: string | null;\n}\n\n/** Type of transaction: credit (add) or debit (remove). */\nexport type FidelityTransactionTypeType = \"credit\" | \"debit\";\n\n/**\n * A single fidelity program transaction.\n */\nexport interface IFidelityTransaction {\n  /** Unique identifier for the transaction. */\n  id: string;\n  /** Amount of the transaction. */\n  amount: number;\n  /** Human-readable description. */\n  description: string;\n  /** ISO 8601 date string. */\n  date: string;\n  /** Type of transaction */\n  type: FidelityTransactionTypeType;\n}\n\n/**\n * The initialization options required to set up the Mini-App SDK.\n */\nexport type IInitializationOptions = {};\n\n/**\n * The post initialization response\n */\nexport interface IInitializationResponse<\n  Env extends Record<string, unknown> = Record<string, unknown>,\n  UserData extends Record<string, unknown> = Record<string, unknown>,\n  Params extends Record<string, unknown> = Record<string, unknown>,\n> {\n  /** The name of the mini app */\n  name: string;\n  /** The uuid of the mini app */\n  uuid: string;\n  /** The description of the mini app */\n  description: string;\n  /** The authors of the mini app */\n  authors?: string;\n  /** The current version in the registry */\n  version?: string;\n  /** The scoped profile based on the requested fields during initialization or the getUserProfile call */\n  profile: Partial<IUserProfile | null>;\n  /** The environment variables defined for the mini app in the shell's backend */\n  env: Env;\n  /** The user data passed during the initialization or the setUserData call */\n  userData: UserData;\n  /** The params passed during the initialization */\n  params: Params;\n}\n\n/**\n * Events emitted by the UI module.\n */\nexport enum UIEvent {\n  /** Triggered when the user performs a native \"Pull-to-Refresh\". */\n  TOP_SCROLL_MORE = \"TOP_SCROLL_MORE\",\n  /** Triggered when the user scrolls near the bottom of the page (within 200px threshold). */\n  BOTTOM_SCROLL_MORE = \"BOTTOM_SCROLL_MORE\",\n}\n\n/**\n * Union type for all SDK events, allowing for both known enums and custom strings.\n * The (string & {}) pattern preserves IntelliSense for enum members.\n */\nexport type SDKEvent = UIEvent | (string & {});\n\n/**\n * Configuration for native scroll interactions managed by the Host Shell.\n */\nexport interface ScrollConfig {\n  /** Configuration for Pull-to-Refresh (Top). */\n  topScrollMore?: {\n    /** Show/hide the native RefreshControl. */\n    enabled: boolean;\n    /** Set to true to show the loading spinner, false to hide it. */\n    refreshing?: boolean;\n  };\n  /** Configuration for Infinite Scroll (Bottom). */\n  bottomScrollMore?: {\n    /** Enable/disable bottom scroll detection. */\n    enabled: boolean;\n    /** If false, detection stops and the indicator is hidden. */\n    hasMore?: boolean;\n    /** Set to true to show the bottom ActivityIndicator. */\n    loadingMore?: boolean;\n  };\n}\n","export { MiniAppSDK, sdk } from \"@miniapps-sdk/sdk\";\nexport * from \"@miniapps-sdk/types\";\n\nimport { sdk } from \"@miniapps-sdk/sdk\";\n\nexport default sdk;\n"],"mappings":"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","names":["UIEvent"]}