@alien_org/contract 0.2.1 → 0.2.3

package/dist/index.d.cts

@@ -51,7 +51,7 @@ type Empty = Record<string, never>;
  * @since 0.1.1
  * @schema
  */
-type PaymentErrorCode = 'insufficient_balance' | 'network_error' | 'pre_checkout_rejected' | 'pre_checkout_timeout' | 'unknown';
+type PaymentErrorCode = 'insufficient_balance' | 'network_error' | 'unknown';
 /**
  * Webhook status for payment results (on-chain truth).
  * - `'finalized'`: Transaction confirmed on-chain
@@ -149,8 +149,6 @@ interface Events {
      * Error code (present when status is 'failed').
      * - `insufficient_balance`: User doesn't have enough tokens
      * - `network_error`: Blockchain network issue
-     * - `pre_checkout_rejected`: Backend rejected the payment in pre-checkout
-     * - `pre_checkout_timeout`: Backend didn't respond to pre-checkout in time
      * - `unknown`: Unexpected error
      * @since 0.1.1
      * @schema
@@ -197,6 +195,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 +217,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.
@@ -344,7 +354,6 @@ interface Methods {
      *
      * **Pre-broadcast errors** (no webhook):
      * `'error:insufficient_balance'`, `'error:network_error'`,
-     * `'error:pre_checkout_rejected'`, `'error:pre_checkout_timeout'`,
      * `'error:unknown'`
      *
      * @example
@@ -476,4 +485,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

@@ -51,7 +51,7 @@ type Empty = Record<string, never>;
  * @since 0.1.1
  * @schema
  */
-type PaymentErrorCode = 'insufficient_balance' | 'network_error' | 'pre_checkout_rejected' | 'pre_checkout_timeout' | 'unknown';
+type PaymentErrorCode = 'insufficient_balance' | 'network_error' | 'unknown';
 /**
  * Webhook status for payment results (on-chain truth).
  * - `'finalized'`: Transaction confirmed on-chain
@@ -149,8 +149,6 @@ interface Events {
      * Error code (present when status is 'failed').
      * - `insufficient_balance`: User doesn't have enough tokens
      * - `network_error`: Blockchain network issue
-     * - `pre_checkout_rejected`: Backend rejected the payment in pre-checkout
-     * - `pre_checkout_timeout`: Backend didn't respond to pre-checkout in time
      * - `unknown`: Unexpected error
      * @since 0.1.1
      * @schema
@@ -197,6 +195,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 +217,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.
@@ -344,7 +354,6 @@ interface Methods {
      *
      * **Pre-broadcast errors** (no webhook):
      * `'error:insufficient_balance'`, `'error:network_error'`,
-     * `'error:pre_checkout_rejected'`, `'error:pre_checkout_timeout'`,
      * `'error:unknown'`
      *
      * @example
@@ -476,4 +485,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.1",
+  "version": "0.2.3",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",