@alien_org/contract 0.1.2 → 0.1.3

package/dist/index.cjs

@@ -14,7 +14,8 @@ const releases = {
 		"payment:request",
 		"clipboard:write",
 		"clipboard:read"
-	]
+	],
+	"0.1.3": ["link:open"]
 };
 
 //#endregion

package/dist/index.d.cts

@@ -383,6 +383,44 @@ interface Methods {
    * @schema
    */
   'clipboard:read': CreateMethodPayload<WithReqId<Empty>>;
+  /**
+   * Open a URL.
+   *
+   * The host app acts as middleware: parses the URL, checks permissions/auth,
+   * and routes to the appropriate handler based on URL and `openMode`.
+   *
+   * **`external`** (default) - Open outside the host app:
+   * - Custom schemes (`solana:`, `mailto:`) → system handler
+   * - HTTPS → system browser
+   *
+   * **`internal`** - Open within the host app:
+   * - Miniapp links → open miniapp (handles auth if required)
+   * - Other links → in-app webview
+   *
+   * @example
+   * emit('link:open', { url: 'solana:...' });
+   * emit('link:open', { url: 'mailto:hi@example.com' });
+   * emit('link:open', { url: 'https://example.com', openMode: 'internal' });
+   *
+   * @since 0.1.3
+   * @schema
+   */
+  'link:open': CreateMethodPayload<{
+    /**
+     * The URL to open.
+     * @since 0.1.3
+     * @schema
+     */
+    url: string;
+    /**
+     * Where to open the URL.
+     * - `external` (default): System browser or app handler
+     * - `internal`: Within the host app (miniapps, webviews)
+     * @since 0.1.3
+     * @schema
+     */
+    openMode?: 'external' | 'internal';
+  }>;
 }
 //#endregion
 //#region src/methods/types/method-types.d.ts

package/dist/index.d.mts

@@ -383,6 +383,44 @@ interface Methods {
    * @schema
    */
   'clipboard:read': CreateMethodPayload<WithReqId<Empty>>;
+  /**
+   * Open a URL.
+   *
+   * The host app acts as middleware: parses the URL, checks permissions/auth,
+   * and routes to the appropriate handler based on URL and `openMode`.
+   *
+   * **`external`** (default) - Open outside the host app:
+   * - Custom schemes (`solana:`, `mailto:`) → system handler
+   * - HTTPS → system browser
+   *
+   * **`internal`** - Open within the host app:
+   * - Miniapp links → open miniapp (handles auth if required)
+   * - Other links → in-app webview
+   *
+   * @example
+   * emit('link:open', { url: 'solana:...' });
+   * emit('link:open', { url: 'mailto:hi@example.com' });
+   * emit('link:open', { url: 'https://example.com', openMode: 'internal' });
+   *
+   * @since 0.1.3
+   * @schema
+   */
+  'link:open': CreateMethodPayload<{
+    /**
+     * The URL to open.
+     * @since 0.1.3
+     * @schema
+     */
+    url: string;
+    /**
+     * Where to open the URL.
+     * - `external` (default): System browser or app handler
+     * - `internal`: Within the host app (miniapps, webviews)
+     * @since 0.1.3
+     * @schema
+     */
+    openMode?: 'external' | 'internal';
+  }>;
 }
 //#endregion
 //#region src/methods/types/method-types.d.ts

package/dist/index.mjs

@@ -13,7 +13,8 @@ const releases = {
 		"payment:request",
 		"clipboard:write",
 		"clipboard:read"
-	]
+	],
+	"0.1.3": ["link:open"]
 };
 
 //#endregion

package/package.json

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