@alien_org/contract 0.0.17-beta → 0.1.1

package/README.md

@@ -1,5 +1,7 @@
 # @alien_org/contract
 
+[![npm](https://img.shields.io/npm/v/@alien_org/contract.svg)](https://www.npmjs.com/package/@alien_org/contract)
+
 Type definitions and version utilities for miniapp-host communication.
 
 ## Installation

package/dist/index.cjs

@@ -9,7 +9,12 @@ 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.0.14": ["miniapp:close.ack", "host.back.button:toggle"],
+	"0.1.1": [
+		"payment:request",
+		"clipboard:write",
+		"clipboard:read"
+	]
 };
 
 //#endregion

package/dist/index.d.cts

@@ -83,7 +83,7 @@ interface Events {
    * For instant fulfillment, your backend should fulfill on webhook receipt
    * using the `invoice` from the request.
    *
-   * @since 0.0.14
+   * @since 0.1.1
    * @schema
    */
   'payment:response': CreateEventPayload<WithReqId<{
@@ -92,13 +92,13 @@ interface Events {
      * - `paid`: Success
      * - `cancelled`: User rejected
      * - `failed`: Error (check `errorCode`)
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     status: 'paid' | 'cancelled' | 'failed';
     /**
      * Transaction hash (present when status is 'paid').
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     txHash?: string;
@@ -109,11 +109,36 @@ interface Events {
      * - `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.0.14
+     * @since 0.1.1
      * @schema
      */
     errorCode?: 'insufficient_balance' | 'network_error' | 'pre_checkout_rejected' | 'pre_checkout_timeout' | 'unknown';
   }>>;
+  /**
+   * Clipboard read response.
+   *
+   * On success: `text` contains the clipboard content (may be empty string).
+   * On failure: `text` is null and `errorCode` indicates the reason.
+   *
+   * @since 0.1.1
+   * @schema
+   */
+  'clipboard:response': CreateEventPayload<WithReqId<{
+    /**
+     * Text from clipboard. Null if read failed.
+     * @since 0.1.1
+     * @schema
+     */
+    text: string | null;
+    /**
+     * Error code if clipboard read failed.
+     * - `permission_denied`: User denied clipboard access
+     * - `unavailable`: Clipboard is not available
+     * @since 0.1.1
+     * @schema
+     */
+    errorCode?: 'permission_denied' | 'unavailable';
+  }>>;
 }
 //#endregion
 //#region src/events/types/event-types.d.ts
@@ -204,61 +229,61 @@ interface Methods {
    * Set `test: true` for test mode - no real payment is made, but webhooks
    * are fired with `test: true` flag. Use for development and testing.
    *
-   * @since 0.0.14
+   * @since 0.1.1
    * @schema
    */
   'payment:request': CreateMethodPayload<WithReqId<{
     /**
      * The recipient's wallet address.
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     recipient: string;
     /**
      * The amount to pay (in token's smallest unit, as string for precision).
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     amount: string;
     /**
      * The token identifier (e.g., 'SOL', 'ALIEN', or contract address).
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     token: string;
     /**
      * The network for the payment ('solana' or 'alien').
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     network: string;
     /**
      * Your order/invoice ID for backend correlation and instant fulfillment.
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     invoice: string;
     /**
      * Item title shown on the approval screen.
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     title?: string;
     /**
      * Item description/caption shown on the approval screen.
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     caption?: string;
     /**
      * Item icon URL shown on the approval screen.
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     iconUrl?: string;
     /**
      * Quantity of items being purchased.
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     quantity?: number;
@@ -266,11 +291,30 @@ interface Methods {
      * Test mode flag. When true, no real payment is processed.
      * The approval screen shows a test indicator, and webhooks
      * include `test: true`. Use for development and testing.
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     test?: boolean;
   }>>;
+  /**
+   * Write text to the system clipboard.
+   * @since 0.1.1
+   * @schema
+   */
+  'clipboard:write': CreateMethodPayload<{
+    /**
+     * Text to copy to clipboard.
+     * @since 0.1.1
+     * @schema
+     */
+    text: string;
+  }>;
+  /**
+   * Read text from the system clipboard.
+   * @since 0.1.1
+   * @schema
+   */
+  'clipboard:read': CreateMethodPayload<WithReqId<Empty>>;
 }
 //#endregion
 //#region src/methods/types/method-types.d.ts

package/dist/index.d.mts

@@ -83,7 +83,7 @@ interface Events {
    * For instant fulfillment, your backend should fulfill on webhook receipt
    * using the `invoice` from the request.
    *
-   * @since 0.0.14
+   * @since 0.1.1
    * @schema
    */
   'payment:response': CreateEventPayload<WithReqId<{
@@ -92,13 +92,13 @@ interface Events {
      * - `paid`: Success
      * - `cancelled`: User rejected
      * - `failed`: Error (check `errorCode`)
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     status: 'paid' | 'cancelled' | 'failed';
     /**
      * Transaction hash (present when status is 'paid').
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     txHash?: string;
@@ -109,11 +109,36 @@ interface Events {
      * - `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.0.14
+     * @since 0.1.1
      * @schema
      */
     errorCode?: 'insufficient_balance' | 'network_error' | 'pre_checkout_rejected' | 'pre_checkout_timeout' | 'unknown';
   }>>;
+  /**
+   * Clipboard read response.
+   *
+   * On success: `text` contains the clipboard content (may be empty string).
+   * On failure: `text` is null and `errorCode` indicates the reason.
+   *
+   * @since 0.1.1
+   * @schema
+   */
+  'clipboard:response': CreateEventPayload<WithReqId<{
+    /**
+     * Text from clipboard. Null if read failed.
+     * @since 0.1.1
+     * @schema
+     */
+    text: string | null;
+    /**
+     * Error code if clipboard read failed.
+     * - `permission_denied`: User denied clipboard access
+     * - `unavailable`: Clipboard is not available
+     * @since 0.1.1
+     * @schema
+     */
+    errorCode?: 'permission_denied' | 'unavailable';
+  }>>;
 }
 //#endregion
 //#region src/events/types/event-types.d.ts
@@ -204,61 +229,61 @@ interface Methods {
    * Set `test: true` for test mode - no real payment is made, but webhooks
    * are fired with `test: true` flag. Use for development and testing.
    *
-   * @since 0.0.14
+   * @since 0.1.1
    * @schema
    */
   'payment:request': CreateMethodPayload<WithReqId<{
     /**
      * The recipient's wallet address.
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     recipient: string;
     /**
      * The amount to pay (in token's smallest unit, as string for precision).
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     amount: string;
     /**
      * The token identifier (e.g., 'SOL', 'ALIEN', or contract address).
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     token: string;
     /**
      * The network for the payment ('solana' or 'alien').
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     network: string;
     /**
      * Your order/invoice ID for backend correlation and instant fulfillment.
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     invoice: string;
     /**
      * Item title shown on the approval screen.
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     title?: string;
     /**
      * Item description/caption shown on the approval screen.
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     caption?: string;
     /**
      * Item icon URL shown on the approval screen.
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     iconUrl?: string;
     /**
      * Quantity of items being purchased.
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     quantity?: number;
@@ -266,11 +291,30 @@ interface Methods {
      * Test mode flag. When true, no real payment is processed.
      * The approval screen shows a test indicator, and webhooks
      * include `test: true`. Use for development and testing.
-     * @since 0.0.14
+     * @since 0.1.1
      * @schema
      */
     test?: boolean;
   }>>;
+  /**
+   * Write text to the system clipboard.
+   * @since 0.1.1
+   * @schema
+   */
+  'clipboard:write': CreateMethodPayload<{
+    /**
+     * Text to copy to clipboard.
+     * @since 0.1.1
+     * @schema
+     */
+    text: string;
+  }>;
+  /**
+   * Read text from the system clipboard.
+   * @since 0.1.1
+   * @schema
+   */
+  'clipboard:read': CreateMethodPayload<WithReqId<Empty>>;
 }
 //#endregion
 //#region src/methods/types/method-types.d.ts

package/dist/index.mjs

@@ -8,7 +8,12 @@ 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.0.14": ["miniapp:close.ack", "host.back.button:toggle"],
+	"0.1.1": [
+		"payment:request",
+		"clipboard:write",
+		"clipboard:read"
+	]
 };
 
 //#endregion

package/package.json

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