@alien_org/contract 1.0.0-alpha → 1.1.1-alpha

package/dist/index.cjs

@@ -21,13 +21,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"
-	]
+	],
+	"1.1.0": ["fullscreen:request", "fullscreen:exit"]
 };
 
 //#endregion
@@ -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

@@ -87,6 +87,14 @@ type PaymentWebhookStatus = 'finalized' | 'failed';
  * @schema
  */
 type PaymentTestScenario = 'paid' | 'paid:failed' | 'cancelled' | `error:${PaymentErrorCode}`;
+/**
+ * Fullscreen error codes.
+ * Returned in `fullscreen:failed` event when fullscreen request fails.
+ * - `ALREADY_FULLSCREEN`: Miniapp is already in fullscreen mode
+ * @since 1.1.0
+ * @schema
+ */
+type FullscreenErrorCode = 'ALREADY_FULLSCREEN';
 /**
  * Haptic impact feedback styles.
  * Maps to UIImpactFeedbackGenerator styles on iOS
@@ -116,7 +124,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 +140,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 +154,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 +162,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';
@@ -251,9 +259,38 @@ interface Events {
      */
     errorCode?: 'permission_denied' | 'unavailable';
   }>>;
+  /**
+   * Fullscreen state changed, fired by the host app
+   * after `fullscreen:request` or `fullscreen:exit`.
+   * @since 1.1.0
+   * @schema
+   */
+  'fullscreen:changed': CreateEventPayload<{
+    /**
+     * Whether the miniapp is currently in fullscreen mode.
+     * @since 1.1.0
+     * @schema
+     */
+    isFullscreen: boolean;
+  }>;
+  /**
+   * Fullscreen request failed.
+   * Fired by the host app when `fullscreen:request` cannot be fulfilled
+   * (e.g., the miniapp is already in fullscreen mode).
+   * @since 1.1.0
+   * @schema
+   */
+  'fullscreen:failed': CreateEventPayload<{
+    /**
+     * Error code indicating why the fullscreen request failed.
+     * @since 1.1.0
+     * @schema
+     */
+    error: FullscreenErrorCode;
+  }>;
   /**
    * Solana wallet connection response.
-   * @since 0.3.0
+   * @since 1.0.0
    * @schema
    */
   'wallet.solana:connect.response': CreateEventPayload<WithReqId<{
@@ -266,7 +303,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 +316,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 +331,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 +386,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.1.0
+   */
+  isFullscreen: boolean | undefined;
 }
 //#endregion
 //#region src/methods/types/payload.d.ts
@@ -401,8 +443,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 +636,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 +660,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 +671,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 +682,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;
@@ -658,6 +700,28 @@ interface Methods {
       maxRetries?: number;
     };
   }>>;
+  /**
+   * Request fullscreen mode.
+   * Fire-and-forget — host app responds with `fullscreen:changed` or `fullscreen:failed` event.
+   *
+   * @example
+   * send('fullscreen:request', {});
+   *
+   * @since 1.1.0
+   * @schema
+   */
+  'fullscreen:request': CreateMethodPayload<Empty>;
+  /**
+   * Exit fullscreen mode.
+   * Fire-and-forget — host app responds with `fullscreen:changed` event.
+   *
+   * @example
+   * send('fullscreen:exit', {});
+   *
+   * @since 1.1.0
+   * @schema
+   */
+  'fullscreen:exit': CreateMethodPayload<Empty>;
 }
 //#endregion
 //#region src/methods/types/method-types.d.ts
@@ -712,4 +776,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, type EventName, type EventPayload, type Events, type FullscreenErrorCode, 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

@@ -87,6 +87,14 @@ type PaymentWebhookStatus = 'finalized' | 'failed';
  * @schema
  */
 type PaymentTestScenario = 'paid' | 'paid:failed' | 'cancelled' | `error:${PaymentErrorCode}`;
+/**
+ * Fullscreen error codes.
+ * Returned in `fullscreen:failed` event when fullscreen request fails.
+ * - `ALREADY_FULLSCREEN`: Miniapp is already in fullscreen mode
+ * @since 1.1.0
+ * @schema
+ */
+type FullscreenErrorCode = 'ALREADY_FULLSCREEN';
 /**
  * Haptic impact feedback styles.
  * Maps to UIImpactFeedbackGenerator styles on iOS
@@ -116,7 +124,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 +140,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 +154,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 +162,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';
@@ -251,9 +259,38 @@ interface Events {
      */
     errorCode?: 'permission_denied' | 'unavailable';
   }>>;
+  /**
+   * Fullscreen state changed, fired by the host app
+   * after `fullscreen:request` or `fullscreen:exit`.
+   * @since 1.1.0
+   * @schema
+   */
+  'fullscreen:changed': CreateEventPayload<{
+    /**
+     * Whether the miniapp is currently in fullscreen mode.
+     * @since 1.1.0
+     * @schema
+     */
+    isFullscreen: boolean;
+  }>;
+  /**
+   * Fullscreen request failed.
+   * Fired by the host app when `fullscreen:request` cannot be fulfilled
+   * (e.g., the miniapp is already in fullscreen mode).
+   * @since 1.1.0
+   * @schema
+   */
+  'fullscreen:failed': CreateEventPayload<{
+    /**
+     * Error code indicating why the fullscreen request failed.
+     * @since 1.1.0
+     * @schema
+     */
+    error: FullscreenErrorCode;
+  }>;
   /**
    * Solana wallet connection response.
-   * @since 0.3.0
+   * @since 1.0.0
    * @schema
    */
   'wallet.solana:connect.response': CreateEventPayload<WithReqId<{
@@ -266,7 +303,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 +316,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 +331,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 +386,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.1.0
+   */
+  isFullscreen: boolean | undefined;
 }
 //#endregion
 //#region src/methods/types/payload.d.ts
@@ -401,8 +443,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 +636,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 +660,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 +671,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 +682,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;
@@ -658,6 +700,28 @@ interface Methods {
       maxRetries?: number;
     };
   }>>;
+  /**
+   * Request fullscreen mode.
+   * Fire-and-forget — host app responds with `fullscreen:changed` or `fullscreen:failed` event.
+   *
+   * @example
+   * send('fullscreen:request', {});
+   *
+   * @since 1.1.0
+   * @schema
+   */
+  'fullscreen:request': CreateMethodPayload<Empty>;
+  /**
+   * Exit fullscreen mode.
+   * Fire-and-forget — host app responds with `fullscreen:changed` event.
+   *
+   * @example
+   * send('fullscreen:exit', {});
+   *
+   * @since 1.1.0
+   * @schema
+   */
+  'fullscreen:exit': CreateMethodPayload<Empty>;
 }
 //#endregion
 //#region src/methods/types/method-types.d.ts
@@ -712,4 +776,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, type EventName, type EventPayload, type Events, type FullscreenErrorCode, 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

@@ -20,13 +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"
-	]
+	],
+	"1.1.0": ["fullscreen:request", "fullscreen:exit"]
 };
 
 //#endregion
@@ -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.1.1-alpha",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",