@alien_org/contract 1.0.0-alpha → 1.0.0-alpha.3

package/README.md

@@ -33,6 +33,7 @@ import type {
   // Launch parameters
   LaunchParams,         // Host-injected params (authToken, contractVersion, etc.)
   Platform,             // 'ios' | 'android'
+  DisplayMode,          // 'standard' | 'fullscreen' | 'immersive'
 
   // Utilities
   Version,              // Semantic version string type
@@ -42,10 +43,11 @@ import type {
 ### Constants
 
 ```typescript
-import { PLATFORMS, releases } from '@alien_org/contract';
+import { DISPLAY_MODES, PLATFORMS, releases } from '@alien_org/contract';
 
-PLATFORMS  // ['ios', 'android']
-releases   // Record<Version, MethodName[]> - version to methods mapping
+PLATFORMS      // ['ios', 'android']
+DISPLAY_MODES  // ['standard', 'fullscreen', 'immersive']
+releases       // Record<Version, MethodName[]> - version to methods mapping
 ```
 
 ### Version Utilities
@@ -63,7 +65,7 @@ isMethodSupported('payment:request', '0.0.9');   // false
 
 // Get minimum version that supports a method
 getMethodMinVersion('app:ready');         // '0.0.9'
-getMethodMinVersion('payment:request');   // '0.0.14'
+getMethodMinVersion('payment:request');   // '0.1.1'
 
 // Get version where a method was introduced
 getReleaseVersion('app:ready');           // '0.0.9'
@@ -74,17 +76,33 @@ getReleaseVersion('app:ready');           // '0.0.9'
 | Method | Since | Description |
 |--------|-------|-------------|
 | `app:ready` | 0.0.9 | Notify host that miniapp is ready |
-| `miniapp:close.ack` | 0.0.14 | Acknowledge close request |
-| `host.back.button:toggle` | 0.0.14 | Show/hide back button |
-| `payment:request` | 0.0.14 | Request payment |
+| `payment:request` | 0.1.1 | Request payment |
+| `clipboard:write` | 0.1.1 | Write text to clipboard |
+| `clipboard:read` | 0.1.1 | Read text from clipboard |
+| `link:open` | 0.1.3 | Open a URL |
+| `haptic:impact` | 0.2.4 | Trigger haptic impact feedback |
+| `haptic:notification` | 0.2.4 | Trigger haptic notification feedback |
+| `haptic:selection` | 0.2.4 | Trigger haptic selection feedback |
+| `wallet.solana:connect` | 1.0.0 | Request Solana wallet connection |
+| `wallet.solana:disconnect` | 1.0.0 | Disconnect from Solana wallet |
+| `wallet.solana:sign.transaction` | 1.0.0 | Sign a Solana transaction |
+| `wallet.solana:sign.message` | 1.0.0 | Sign a Solana message |
+| `wallet.solana:sign.send` | 1.0.0 | Sign and send a Solana transaction |
+| `app:close` | 1.0.0 | Request host to close the miniapp |
+| `host.back.button:toggle` | 1.0.0 | Show/hide back button |
 
 ## Available Events
 
 | Event | Since | Description |
 |-------|-------|-------------|
 | `miniapp:close` | 0.0.14 | Host is closing miniapp |
-| `host.back.button:clicked` | 0.0.14 | Back button was clicked |
-| `payment:response` | 0.0.14 | Payment result |
+| `host.back.button:clicked` | 1.0.0 | Back button was clicked |
+| `payment:response` | 0.1.1 | Payment result |
+| `clipboard:response` | 0.1.1 | Clipboard read result |
+| `wallet.solana:connect.response` | 1.0.0 | Wallet connection result |
+| `wallet.solana:sign.transaction.response` | 1.0.0 | Transaction signing result |
+| `wallet.solana:sign.message.response` | 1.0.0 | Message signing result |
+| `wallet.solana:sign.send.response` | 1.0.0 | Sign and send result |
 
 ## LaunchParams
 
@@ -92,11 +110,13 @@ Parameters injected by the host app:
 
 ```typescript
 interface LaunchParams {
-  authToken: string | undefined;        // JWT auth token
-  contractVersion: Version | undefined; // Host's contract version
-  hostAppVersion: string | undefined;   // Host app version
-  platform: Platform | undefined;       // 'ios' | 'android'
-  startParam: string | undefined;       // Custom param (referrals, etc.)
+  authToken: string | undefined;           // JWT auth token
+  contractVersion: Version | undefined;    // Host's contract version
+  hostAppVersion: string | undefined;      // Host app version
+  platform: Platform | undefined;          // 'ios' | 'android'
+  safeAreaInsets: SafeAreaInsets | undefined; // System UI insets (CSS px)
+  startParam: string | undefined;          // Custom param (referrals, etc.)
+  displayMode: DisplayMode;                 // 'standard' | 'fullscreen' | 'immersive'
 }
 ```
 

package/dist/index.cjs

@@ -4,12 +4,22 @@
 * Supported platforms for miniapps.
 */
 const PLATFORMS = ["ios", "android"];
+/**
+* Supported display modes for miniapps.
+* - `standard` — standard webview with native chrome
+* - `fullscreen` — fullscreen webview, native controls still visible
+* - `immersive` — no native UI elements at all (no close button, options, etc.)
+*/
+const DISPLAY_MODES = [
+	"standard",
+	"fullscreen",
+	"immersive"
+];
 
 //#endregion
 //#region src/methods/versions/releases.ts
 const releases = {
 	"0.0.9": ["app:ready"],
-	"0.0.14": ["miniapp:close.ack", "host.back.button:toggle"],
 	"0.1.1": [
 		"payment:request",
 		"clipboard:write",
@@ -21,12 +31,14 @@ const releases = {
 		"haptic:notification",
 		"haptic:selection"
 	],
-	"0.3.0": [
+	"1.0.0": [
 		"wallet.solana:connect",
 		"wallet.solana:disconnect",
 		"wallet.solana:sign.transaction",
 		"wallet.solana:sign.message",
-		"wallet.solana:sign.send"
+		"wallet.solana:sign.send",
+		"app:close",
+		"host.back.button:toggle"
 	]
 };
 
@@ -104,7 +116,7 @@ function getMethodMinVersion(method) {
 * }
 * ```
 *
-* @since 0.3.0
+* @since 1.0.0
 */
 const WALLET_ERROR = {
 	USER_REJECTED: 5e3,
@@ -114,6 +126,7 @@ const WALLET_ERROR = {
 };
 
 //#endregion
+exports.DISPLAY_MODES = DISPLAY_MODES;
 exports.PLATFORMS = PLATFORMS;
 exports.WALLET_ERROR = WALLET_ERROR;
 exports.getMethodMinVersion = getMethodMinVersion;

package/dist/index.d.cts

@@ -116,7 +116,7 @@ type HapticNotificationType = 'success' | 'warning' | 'error';
  * | `-32603` | Internal error (send failed, unexpected error) | JSON-RPC standard |
  * | `8000` | Request expired / timed out | `sessionRequestExpired` |
  *
- * @since 0.3.0
+ * @since 1.0.0
  * @schema
  */
 type WalletSolanaErrorCode = 5000 | -32602 | -32603 | 8000;
@@ -132,7 +132,7 @@ type WalletSolanaErrorCode = 5000 | -32602 | -32603 | 8000;
  * }
  * ```
  *
- * @since 0.3.0
+ * @since 1.0.0
  */
 declare const WALLET_ERROR: {
   /** User rejected the request (cancelled approval screen). */
@@ -146,7 +146,7 @@ declare const WALLET_ERROR: {
 };
 /**
  * Solana commitment levels for send options.
- * @since 0.3.0
+ * @since 1.0.0
  * @schema
  */
 type SolanaCommitment = 'processed' | 'confirmed' | 'finalized';
@@ -154,7 +154,7 @@ type SolanaCommitment = 'processed' | 'confirmed' | 'finalized';
  * Solana chain identifiers (wallet-standard format).
  * Used by `wallet.solana:sign.send` to tell the host app
  * which cluster to broadcast to.
- * @since 0.3.0
+ * @since 1.0.0
  * @schema
  */
 type SolanaChain = 'solana:mainnet' | 'solana:devnet' | 'solana:testnet';
@@ -182,7 +182,7 @@ interface Events {
   'miniapp:close': CreateEventPayload<Empty>;
   /**
    * Host app's back button clicked event.
-   * @since 0.0.14
+   * @since 1.0.0
    * @schema
    */
   'host.back.button:clicked': CreateEventPayload<Empty>;
@@ -253,7 +253,7 @@ interface Events {
   }>>;
   /**
    * Solana wallet connection response.
-   * @since 0.3.0
+   * @since 1.0.0
    * @schema
    */
   'wallet.solana:connect.response': CreateEventPayload<WithReqId<{
@@ -266,7 +266,7 @@ interface Events {
   }>>;
   /**
    * Solana transaction signing response.
-   * @since 0.3.0
+   * @since 1.0.0
    * @schema
    */
   'wallet.solana:sign.transaction.response': CreateEventPayload<WithReqId<{
@@ -279,7 +279,7 @@ interface Events {
   }>>;
   /**
    * Solana message signing response.
-   * @since 0.3.0
+   * @since 1.0.0
    * @schema
    */
   'wallet.solana:sign.message.response': CreateEventPayload<WithReqId<{
@@ -294,7 +294,7 @@ interface Events {
   }>>;
   /**
    * Solana sign-and-send transaction response.
-   * @since 0.3.0
+   * @since 1.0.0
    * @schema
    */
   'wallet.solana:sign.send.response': CreateEventPayload<WithReqId<{
@@ -320,6 +320,17 @@ declare const PLATFORMS: readonly ["ios", "android"];
  * Platform the miniapp is running on.
  */
 type Platform = (typeof PLATFORMS)[number];
+/**
+ * Supported display modes for miniapps.
+ * - `standard` — standard webview with native chrome
+ * - `fullscreen` — fullscreen webview, native controls still visible
+ * - `immersive` — no native UI elements at all (no close button, options, etc.)
+ */
+declare const DISPLAY_MODES: readonly ["standard", "fullscreen", "immersive"];
+/**
+ * Display mode for the miniapp webview.
+ */
+type DisplayMode = (typeof DISPLAY_MODES)[number];
 /**
  * Safe area insets in CSS pixels, injected by the host app.
  * Accounts for system UI (status bar, notch, home indicator, nav bar).
@@ -349,6 +360,12 @@ interface LaunchParams {
    * Used for referral codes, campaign tracking, or custom routing.
    */
   startParam: string | undefined;
+  /**
+   * Display mode for the miniapp webview.
+   * Defaults to `'standard'` when not provided by the host app.
+   * @since 1.0.0
+   */
+  displayMode: DisplayMode;
 }
 //#endregion
 //#region src/methods/types/payload.d.ts
@@ -369,27 +386,27 @@ interface Methods {
   /**
    * Miniapp ready method.
    * Sent by the miniapp to notify the host app that it has loaded and is ready to be displayed.
-   * @since 0.0.1
+   * @since 0.0.9
    * @schema
    */
   'app:ready': CreateMethodPayload<Empty>;
   /**
-   * Miniapp close acknowledgment method.
-   * Sent by the miniapp to notify the host app that it has completed cleanup and is ready to be closed.
-   * Note that if the miniapp takes longer than 10 seconds to close, the host app will force close the miniapp.
-   * @since 0.0.14
+   * Close the miniapp.
+   * Sent by the miniapp to request the host app to close it.
+   * Fire-and-forget — no response expected.
+   * @since 1.0.0
    * @schema
    */
-  'miniapp:close.ack': CreateMethodPayload<Empty>;
+  'app:close': CreateMethodPayload<Empty>;
   /**
    * Toggle host app's back button visibility.
-   * @since 0.0.14
+   * @since 1.0.0
    * @schema
    */
   'host.back.button:toggle': CreateMethodPayload<{
     /**
      * Whether to show or hide the back button.
-     * @since 0.0.14
+     * @since 1.0.0
      * @schema
      */
     visible: boolean;
@@ -401,8 +418,8 @@ interface Methods {
    * Your backend receives a webhook when user pays - fulfill the order
    * immediately without waiting for chain confirmation.
    *
-   * Optional display fields (`title`, `caption`, `iconUrl`, `quantity`)
-   * are shown on the payment approval screen.
+   * Optional `item` object (`title`, `iconUrl`, `quantity`)
+   * is shown on the payment approval screen.
    *
    * 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
@@ -594,21 +611,21 @@ interface Methods {
   /**
    * Request Solana wallet connection.
    * Returns the wallet's public key on success.
-   * @since 0.3.0
+   * @since 1.0.0
    * @schema
    */
   'wallet.solana:connect': CreateMethodPayload<WithReqId<Empty>>;
   /**
    * Disconnect from Solana wallet.
    * Fire-and-forget — no response expected.
-   * @since 0.3.0
+   * @since 1.0.0
    * @schema
    */
   'wallet.solana:disconnect': CreateMethodPayload<Empty>;
   /**
    * Request Solana transaction signing.
    * Returns the signed transaction bytes.
-   * @since 0.3.0
+   * @since 1.0.0
    * @schema
    */
   'wallet.solana:sign.transaction': CreateMethodPayload<WithReqId<{
@@ -618,7 +635,7 @@ interface Methods {
   /**
    * Request Solana message signing.
    * Returns the Ed25519 signature.
-   * @since 0.3.0
+   * @since 1.0.0
    * @schema
    */
   'wallet.solana:sign.message': CreateMethodPayload<WithReqId<{
@@ -629,7 +646,7 @@ interface Methods {
    * Request Solana transaction signing and sending.
    * The host app signs and broadcasts the transaction.
    * Returns the transaction signature.
-   * @since 0.3.0
+   * @since 1.0.0
    * @schema
    */
   'wallet.solana:sign.send': CreateMethodPayload<WithReqId<{
@@ -640,7 +657,7 @@ interface Methods {
      * In bridge mode the host app can infer this from miniapp config,
      * but in relay mode (QR/WebSocket) this is required so the host
      * app knows which RPC to broadcast to.
-     * @since 0.3.0
+     * @since 1.0.0
      * @schema
      */
     chain?: SolanaChain;
@@ -712,4 +729,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 HapticImpactStyle, type HapticNotificationType, type LaunchParams, type MethodName, type MethodNameWithVersionedPayload, type MethodPayload, type MethodVersionedPayload, type Methods, PLATFORMS, type PaymentErrorCode, type PaymentTestScenario, type PaymentWebhookStatus, type Platform, type SafeAreaInsets, type SolanaChain, type SolanaCommitment, type Version, WALLET_ERROR, type WalletSolanaErrorCode, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };
+export { type CreateEventPayload, type CreateMethodPayload, DISPLAY_MODES, type DisplayMode, type EventName, type EventPayload, type Events, type HapticImpactStyle, type HapticNotificationType, type LaunchParams, type MethodName, type MethodNameWithVersionedPayload, type MethodPayload, type MethodVersionedPayload, type Methods, PLATFORMS, type PaymentErrorCode, type PaymentTestScenario, type PaymentWebhookStatus, type Platform, type SafeAreaInsets, type SolanaChain, type SolanaCommitment, type Version, WALLET_ERROR, type WalletSolanaErrorCode, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };

package/dist/index.d.mts

@@ -116,7 +116,7 @@ type HapticNotificationType = 'success' | 'warning' | 'error';
  * | `-32603` | Internal error (send failed, unexpected error) | JSON-RPC standard |
  * | `8000` | Request expired / timed out | `sessionRequestExpired` |
  *
- * @since 0.3.0
+ * @since 1.0.0
  * @schema
  */
 type WalletSolanaErrorCode = 5000 | -32602 | -32603 | 8000;
@@ -132,7 +132,7 @@ type WalletSolanaErrorCode = 5000 | -32602 | -32603 | 8000;
  * }
  * ```
  *
- * @since 0.3.0
+ * @since 1.0.0
  */
 declare const WALLET_ERROR: {
   /** User rejected the request (cancelled approval screen). */
@@ -146,7 +146,7 @@ declare const WALLET_ERROR: {
 };
 /**
  * Solana commitment levels for send options.
- * @since 0.3.0
+ * @since 1.0.0
  * @schema
  */
 type SolanaCommitment = 'processed' | 'confirmed' | 'finalized';
@@ -154,7 +154,7 @@ type SolanaCommitment = 'processed' | 'confirmed' | 'finalized';
  * Solana chain identifiers (wallet-standard format).
  * Used by `wallet.solana:sign.send` to tell the host app
  * which cluster to broadcast to.
- * @since 0.3.0
+ * @since 1.0.0
  * @schema
  */
 type SolanaChain = 'solana:mainnet' | 'solana:devnet' | 'solana:testnet';
@@ -182,7 +182,7 @@ interface Events {
   'miniapp:close': CreateEventPayload<Empty>;
   /**
    * Host app's back button clicked event.
-   * @since 0.0.14
+   * @since 1.0.0
    * @schema
    */
   'host.back.button:clicked': CreateEventPayload<Empty>;
@@ -253,7 +253,7 @@ interface Events {
   }>>;
   /**
    * Solana wallet connection response.
-   * @since 0.3.0
+   * @since 1.0.0
    * @schema
    */
   'wallet.solana:connect.response': CreateEventPayload<WithReqId<{
@@ -266,7 +266,7 @@ interface Events {
   }>>;
   /**
    * Solana transaction signing response.
-   * @since 0.3.0
+   * @since 1.0.0
    * @schema
    */
   'wallet.solana:sign.transaction.response': CreateEventPayload<WithReqId<{
@@ -279,7 +279,7 @@ interface Events {
   }>>;
   /**
    * Solana message signing response.
-   * @since 0.3.0
+   * @since 1.0.0
    * @schema
    */
   'wallet.solana:sign.message.response': CreateEventPayload<WithReqId<{
@@ -294,7 +294,7 @@ interface Events {
   }>>;
   /**
    * Solana sign-and-send transaction response.
-   * @since 0.3.0
+   * @since 1.0.0
    * @schema
    */
   'wallet.solana:sign.send.response': CreateEventPayload<WithReqId<{
@@ -320,6 +320,17 @@ declare const PLATFORMS: readonly ["ios", "android"];
  * Platform the miniapp is running on.
  */
 type Platform = (typeof PLATFORMS)[number];
+/**
+ * Supported display modes for miniapps.
+ * - `standard` — standard webview with native chrome
+ * - `fullscreen` — fullscreen webview, native controls still visible
+ * - `immersive` — no native UI elements at all (no close button, options, etc.)
+ */
+declare const DISPLAY_MODES: readonly ["standard", "fullscreen", "immersive"];
+/**
+ * Display mode for the miniapp webview.
+ */
+type DisplayMode = (typeof DISPLAY_MODES)[number];
 /**
  * Safe area insets in CSS pixels, injected by the host app.
  * Accounts for system UI (status bar, notch, home indicator, nav bar).
@@ -349,6 +360,12 @@ interface LaunchParams {
    * Used for referral codes, campaign tracking, or custom routing.
    */
   startParam: string | undefined;
+  /**
+   * Display mode for the miniapp webview.
+   * Defaults to `'standard'` when not provided by the host app.
+   * @since 1.0.0
+   */
+  displayMode: DisplayMode;
 }
 //#endregion
 //#region src/methods/types/payload.d.ts
@@ -369,27 +386,27 @@ interface Methods {
   /**
    * Miniapp ready method.
    * Sent by the miniapp to notify the host app that it has loaded and is ready to be displayed.
-   * @since 0.0.1
+   * @since 0.0.9
    * @schema
    */
   'app:ready': CreateMethodPayload<Empty>;
   /**
-   * Miniapp close acknowledgment method.
-   * Sent by the miniapp to notify the host app that it has completed cleanup and is ready to be closed.
-   * Note that if the miniapp takes longer than 10 seconds to close, the host app will force close the miniapp.
-   * @since 0.0.14
+   * Close the miniapp.
+   * Sent by the miniapp to request the host app to close it.
+   * Fire-and-forget — no response expected.
+   * @since 1.0.0
    * @schema
    */
-  'miniapp:close.ack': CreateMethodPayload<Empty>;
+  'app:close': CreateMethodPayload<Empty>;
   /**
    * Toggle host app's back button visibility.
-   * @since 0.0.14
+   * @since 1.0.0
    * @schema
    */
   'host.back.button:toggle': CreateMethodPayload<{
     /**
      * Whether to show or hide the back button.
-     * @since 0.0.14
+     * @since 1.0.0
      * @schema
      */
     visible: boolean;
@@ -401,8 +418,8 @@ interface Methods {
    * Your backend receives a webhook when user pays - fulfill the order
    * immediately without waiting for chain confirmation.
    *
-   * Optional display fields (`title`, `caption`, `iconUrl`, `quantity`)
-   * are shown on the payment approval screen.
+   * Optional `item` object (`title`, `iconUrl`, `quantity`)
+   * is shown on the payment approval screen.
    *
    * 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
@@ -594,21 +611,21 @@ interface Methods {
   /**
    * Request Solana wallet connection.
    * Returns the wallet's public key on success.
-   * @since 0.3.0
+   * @since 1.0.0
    * @schema
    */
   'wallet.solana:connect': CreateMethodPayload<WithReqId<Empty>>;
   /**
    * Disconnect from Solana wallet.
    * Fire-and-forget — no response expected.
-   * @since 0.3.0
+   * @since 1.0.0
    * @schema
    */
   'wallet.solana:disconnect': CreateMethodPayload<Empty>;
   /**
    * Request Solana transaction signing.
    * Returns the signed transaction bytes.
-   * @since 0.3.0
+   * @since 1.0.0
    * @schema
    */
   'wallet.solana:sign.transaction': CreateMethodPayload<WithReqId<{
@@ -618,7 +635,7 @@ interface Methods {
   /**
    * Request Solana message signing.
    * Returns the Ed25519 signature.
-   * @since 0.3.0
+   * @since 1.0.0
    * @schema
    */
   'wallet.solana:sign.message': CreateMethodPayload<WithReqId<{
@@ -629,7 +646,7 @@ interface Methods {
    * Request Solana transaction signing and sending.
    * The host app signs and broadcasts the transaction.
    * Returns the transaction signature.
-   * @since 0.3.0
+   * @since 1.0.0
    * @schema
    */
   'wallet.solana:sign.send': CreateMethodPayload<WithReqId<{
@@ -640,7 +657,7 @@ interface Methods {
      * In bridge mode the host app can infer this from miniapp config,
      * but in relay mode (QR/WebSocket) this is required so the host
      * app knows which RPC to broadcast to.
-     * @since 0.3.0
+     * @since 1.0.0
      * @schema
      */
     chain?: SolanaChain;
@@ -712,4 +729,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 HapticImpactStyle, type HapticNotificationType, type LaunchParams, type MethodName, type MethodNameWithVersionedPayload, type MethodPayload, type MethodVersionedPayload, type Methods, PLATFORMS, type PaymentErrorCode, type PaymentTestScenario, type PaymentWebhookStatus, type Platform, type SafeAreaInsets, type SolanaChain, type SolanaCommitment, type Version, WALLET_ERROR, type WalletSolanaErrorCode, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };
+export { type CreateEventPayload, type CreateMethodPayload, DISPLAY_MODES, type DisplayMode, type EventName, type EventPayload, type Events, type HapticImpactStyle, type HapticNotificationType, type LaunchParams, type MethodName, type MethodNameWithVersionedPayload, type MethodPayload, type MethodVersionedPayload, type Methods, PLATFORMS, type PaymentErrorCode, type PaymentTestScenario, type PaymentWebhookStatus, type Platform, type SafeAreaInsets, type SolanaChain, type SolanaCommitment, type Version, WALLET_ERROR, type WalletSolanaErrorCode, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };

package/dist/index.mjs

@@ -3,12 +3,22 @@
 * Supported platforms for miniapps.
 */
 const PLATFORMS = ["ios", "android"];
+/**
+* Supported display modes for miniapps.
+* - `standard` — standard webview with native chrome
+* - `fullscreen` — fullscreen webview, native controls still visible
+* - `immersive` — no native UI elements at all (no close button, options, etc.)
+*/
+const DISPLAY_MODES = [
+	"standard",
+	"fullscreen",
+	"immersive"
+];
 
 //#endregion
 //#region src/methods/versions/releases.ts
 const releases = {
 	"0.0.9": ["app:ready"],
-	"0.0.14": ["miniapp:close.ack", "host.back.button:toggle"],
 	"0.1.1": [
 		"payment:request",
 		"clipboard:write",
@@ -20,12 +30,14 @@ const releases = {
 		"haptic:notification",
 		"haptic:selection"
 	],
-	"0.3.0": [
+	"1.0.0": [
 		"wallet.solana:connect",
 		"wallet.solana:disconnect",
 		"wallet.solana:sign.transaction",
 		"wallet.solana:sign.message",
-		"wallet.solana:sign.send"
+		"wallet.solana:sign.send",
+		"app:close",
+		"host.back.button:toggle"
 	]
 };
 
@@ -103,7 +115,7 @@ function getMethodMinVersion(method) {
 * }
 * ```
 *
-* @since 0.3.0
+* @since 1.0.0
 */
 const WALLET_ERROR = {
 	USER_REJECTED: 5e3,
@@ -113,4 +125,4 @@ const WALLET_ERROR = {
 };
 
 //#endregion
-export { PLATFORMS, WALLET_ERROR, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };
+export { DISPLAY_MODES, PLATFORMS, WALLET_ERROR, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };

package/package.json

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