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

package/README.md

@@ -63,7 +63,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 +74,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 +108,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.)
+  isFullscreen: boolean | undefined;       // Launched in fullscreen mode
 }
 ```
 

package/dist/index.cjs

@@ -9,7 +9,6 @@ const PLATFORMS = ["ios", "android"];
 //#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 +20,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 +105,7 @@ function getMethodMinVersion(method) {
 * }
 * ```
 *
-* @since 0.3.0
+* @since 1.0.0
 */
 const WALLET_ERROR = {
 	USER_REJECTED: 5e3,

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<{
@@ -349,6 +349,11 @@ interface LaunchParams {
    * Used for referral codes, campaign tracking, or custom routing.
    */
   startParam: string | undefined;
+  /**
+   * Whether the miniapp was launched in fullscreen mode.
+   * @since 1.0.0
+   */
+  isFullscreen: boolean | undefined;
 }
 //#endregion
 //#region src/methods/types/payload.d.ts
@@ -369,27 +374,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 +406,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 +599,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 +623,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 +634,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 +645,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;

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<{
@@ -349,6 +349,11 @@ interface LaunchParams {
    * Used for referral codes, campaign tracking, or custom routing.
    */
   startParam: string | undefined;
+  /**
+   * Whether the miniapp was launched in fullscreen mode.
+   * @since 1.0.0
+   */
+  isFullscreen: boolean | undefined;
 }
 //#endregion
 //#region src/methods/types/payload.d.ts
@@ -369,27 +374,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 +406,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 +599,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 +623,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 +634,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 +645,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;

package/dist/index.mjs

@@ -8,7 +8,6 @@ const PLATFORMS = ["ios", "android"];
 //#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 +19,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 +104,7 @@ function getMethodMinVersion(method) {
 * }
 * ```
 *
-* @since 0.3.0
+* @since 1.0.0
 */
 const WALLET_ERROR = {
 	USER_REJECTED: 5e3,

package/package.json

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