@alien_org/contract 0.2.0 → 0.2.2

package/dist/index.d.cts

@@ -197,6 +197,16 @@ declare const PLATFORMS: readonly ["ios", "android"];
  * Platform the miniapp is running on.
  */
 type Platform = (typeof PLATFORMS)[number];
+/**
+ * Safe area insets in CSS pixels, injected by the host app.
+ * Accounts for system UI (status bar, notch, home indicator, nav bar).
+ */
+interface SafeAreaInsets {
+  top: number;
+  right: number;
+  bottom: number;
+  left: number;
+}
 /**
  * Launch parameters injected by the host app.
  */
@@ -209,6 +219,8 @@ interface LaunchParams {
   hostAppVersion: string | undefined;
   /** Platform the miniapp is running on */
   platform: Platform | undefined;
+  /** Safe area insets for the webview in CSS pixels */
+  safeAreaInsets: SafeAreaInsets | undefined;
   /**
    * Custom start parameter injected by host app.
    * Used for referral codes, campaign tracking, or custom routing.
@@ -269,8 +281,9 @@ interface Methods {
    * Optional display fields (`title`, `caption`, `iconUrl`, `quantity`)
    * are shown on the payment approval screen.
    *
-   * Set `test: true` for test mode - no real payment is made, but webhooks
-   * are fired with `test: true` flag. Use for development and testing.
+   * Set `test` to a scenario string (e.g. `'paid'`, `'error:insufficient_balance'`)
+   * for test mode - no real payment is made, but the specified scenario is
+   * simulated. Use for development and testing.
    *
    * @since 0.1.1
    * @schema
@@ -336,7 +349,7 @@ interface Methods {
      *
      * | Scenario | Client | Webhook |
      * |----------|--------|---------|
-     * | `true` / `'paid'` | `paid` | `finalized` |
+     * | `'paid'` | `paid` | `finalized` |
      * | `'paid:failed'` | `paid` | `failed` |
      * | `'cancelled'` | `cancelled` | none |
      * | `'error:*'` | `failed` | none |
@@ -362,7 +375,7 @@ interface Methods {
      * @since 0.1.1
      * @schema
      */
-    test?: boolean | PaymentTestScenario;
+    test?: PaymentTestScenario;
   }>>;
   /**
    * Write text to the system clipboard.
@@ -475,4 +488,4 @@ declare function isMethodSupported(method: MethodName, version: Version): boolea
  */
 declare function getMethodMinVersion(method: MethodName): Version | undefined;
 //#endregion
-export { type CreateEventPayload, type CreateMethodPayload, type EventName, type EventPayload, type Events, type LaunchParams, type MethodName, type MethodNameWithVersionedPayload, type MethodPayload, type MethodVersionedPayload, type Methods, PLATFORMS, type PaymentErrorCode, type PaymentTestScenario, type PaymentWebhookStatus, type Platform, type Version, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };
+export { type CreateEventPayload, type CreateMethodPayload, type EventName, type EventPayload, type Events, type LaunchParams, type MethodName, type MethodNameWithVersionedPayload, type MethodPayload, type MethodVersionedPayload, type Methods, PLATFORMS, type PaymentErrorCode, type PaymentTestScenario, type PaymentWebhookStatus, type Platform, type SafeAreaInsets, type Version, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };

package/dist/index.d.mts

@@ -197,6 +197,16 @@ declare const PLATFORMS: readonly ["ios", "android"];
  * Platform the miniapp is running on.
  */
 type Platform = (typeof PLATFORMS)[number];
+/**
+ * Safe area insets in CSS pixels, injected by the host app.
+ * Accounts for system UI (status bar, notch, home indicator, nav bar).
+ */
+interface SafeAreaInsets {
+  top: number;
+  right: number;
+  bottom: number;
+  left: number;
+}
 /**
  * Launch parameters injected by the host app.
  */
@@ -209,6 +219,8 @@ interface LaunchParams {
   hostAppVersion: string | undefined;
   /** Platform the miniapp is running on */
   platform: Platform | undefined;
+  /** Safe area insets for the webview in CSS pixels */
+  safeAreaInsets: SafeAreaInsets | undefined;
   /**
    * Custom start parameter injected by host app.
    * Used for referral codes, campaign tracking, or custom routing.
@@ -269,8 +281,9 @@ interface Methods {
    * Optional display fields (`title`, `caption`, `iconUrl`, `quantity`)
    * are shown on the payment approval screen.
    *
-   * Set `test: true` for test mode - no real payment is made, but webhooks
-   * are fired with `test: true` flag. Use for development and testing.
+   * Set `test` to a scenario string (e.g. `'paid'`, `'error:insufficient_balance'`)
+   * for test mode - no real payment is made, but the specified scenario is
+   * simulated. Use for development and testing.
    *
    * @since 0.1.1
    * @schema
@@ -336,7 +349,7 @@ interface Methods {
      *
      * | Scenario | Client | Webhook |
      * |----------|--------|---------|
-     * | `true` / `'paid'` | `paid` | `finalized` |
+     * | `'paid'` | `paid` | `finalized` |
      * | `'paid:failed'` | `paid` | `failed` |
      * | `'cancelled'` | `cancelled` | none |
      * | `'error:*'` | `failed` | none |
@@ -362,7 +375,7 @@ interface Methods {
      * @since 0.1.1
      * @schema
      */
-    test?: boolean | PaymentTestScenario;
+    test?: PaymentTestScenario;
   }>>;
   /**
    * Write text to the system clipboard.
@@ -475,4 +488,4 @@ declare function isMethodSupported(method: MethodName, version: Version): boolea
  */
 declare function getMethodMinVersion(method: MethodName): Version | undefined;
 //#endregion
-export { type CreateEventPayload, type CreateMethodPayload, type EventName, type EventPayload, type Events, type LaunchParams, type MethodName, type MethodNameWithVersionedPayload, type MethodPayload, type MethodVersionedPayload, type Methods, PLATFORMS, type PaymentErrorCode, type PaymentTestScenario, type PaymentWebhookStatus, type Platform, type Version, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };
+export { type CreateEventPayload, type CreateMethodPayload, type EventName, type EventPayload, type Events, type LaunchParams, type MethodName, type MethodNameWithVersionedPayload, type MethodPayload, type MethodVersionedPayload, type Methods, PLATFORMS, type PaymentErrorCode, type PaymentTestScenario, type PaymentWebhookStatus, type Platform, type SafeAreaInsets, type Version, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alien_org/contract",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",