@alien_org/react 0.2.1 → 0.2.3

package/dist/index.cjs

@@ -4,6 +4,7 @@ let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 
 //#region src/context.tsx
+const useIsomorphicLayoutEffect$1 = typeof window !== "undefined" ? react.useLayoutEffect : react.useEffect;
 const AlienContext = (0, react.createContext)(null);
 /**
 * Provider component that initializes the Alien miniapp context.
@@ -22,28 +23,36 @@ const AlienContext = (0, react.createContext)(null);
 * }
 * ```
 */
-function AlienProvider({ children, autoReady = true }) {
+function AlienProvider({ children, autoReady = true, interceptLinks = true }) {
 	const readySent = (0, react.useRef)(false);
 	const ready = (0, react.useCallback)(() => {
 		if (readySent.current) return;
 		readySent.current = true;
 		if ((0, _alien_org_bridge.isBridgeAvailable)()) (0, _alien_org_bridge.send)("app:ready", {});
 	}, []);
-	const value = (0, react.useMemo)(() => {
+	const [value, setValue] = (0, react.useState)(() => ({
+		authToken: void 0,
+		contractVersion: void 0,
+		isBridgeAvailable: false,
+		ready
+	}));
+	useIsomorphicLayoutEffect$1(() => {
 		const launchParams = (0, _alien_org_bridge.getLaunchParams)();
-		return {
+		const bridgeAvailable = (0, _alien_org_bridge.isBridgeAvailable)();
+		setValue({
 			authToken: launchParams?.authToken,
 			contractVersion: launchParams?.contractVersion,
-			isBridgeAvailable: (0, _alien_org_bridge.isBridgeAvailable)(),
+			isBridgeAvailable: bridgeAvailable,
 			ready
-		};
+		});
+		if (!bridgeAvailable) console.warn("[@alien_org/react] Bridge is not available. Running in dev mode? The SDK will handle errors gracefully, but bridge communication will not work.");
 	}, [ready]);
-	(0, react.useEffect)(() => {
-		if (!value.isBridgeAvailable) console.warn("[@alien_org/react] Bridge is not available. Running in dev mode? The SDK will handle errors gracefully, but bridge communication will not work.");
-	}, [value.isBridgeAvailable]);
 	(0, react.useEffect)(() => {
 		if (autoReady) ready();
 	}, [autoReady, ready]);
+	(0, react.useEffect)(() => {
+		if (interceptLinks) return (0, _alien_org_bridge.enableLinkInterceptor)();
+	}, [interceptLinks]);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(AlienContext.Provider, {
 		value,
 		children
@@ -259,6 +268,7 @@ function useIsMethodSupported(method) {
 
 //#endregion
 //#region src/hooks/useLaunchParams.ts
+const useIsomorphicLayoutEffect = typeof window !== "undefined" ? react.useLayoutEffect : react.useEffect;
 /**
 * Hook to get launch params.
 * Returns undefined if params unavailable (use mockLaunchParamsForDev in dev).
@@ -279,7 +289,34 @@ function useIsMethodSupported(method) {
 * ```
 */
 function useLaunchParams() {
-	return (0, react.useMemo)(() => (0, _alien_org_bridge.getLaunchParams)(), []);
+	const [params, setParams] = (0, react.useState)(void 0);
+	useIsomorphicLayoutEffect(() => {
+		setParams((0, _alien_org_bridge.getLaunchParams)());
+	}, []);
+	return params;
+}
+
+//#endregion
+//#region src/hooks/useLinkInterceptor.ts
+/**
+* Intercepts external link clicks and routes them through the bridge.
+* Activates when the bridge is available, cleans up on unmount.
+*
+* @example
+* ```tsx
+* function App() {
+*   useLinkInterceptor();
+*   return <a href="https://external.com">Opens via host app</a>;
+* }
+* ```
+*/
+function useLinkInterceptor(options = {}) {
+	const { isBridgeAvailable: isBridgeAvailable$1 } = useAlien();
+	const { openMode } = options;
+	(0, react.useEffect)(() => {
+		if (!isBridgeAvailable$1) return;
+		return (0, _alien_org_bridge.enableLinkInterceptor)({ openMode });
+	}, [isBridgeAvailable$1, openMode]);
 }
 
 //#endregion
@@ -628,5 +665,6 @@ exports.useClipboard = useClipboard;
 exports.useEvent = useEvent;
 exports.useIsMethodSupported = useIsMethodSupported;
 exports.useLaunchParams = useLaunchParams;
+exports.useLinkInterceptor = useLinkInterceptor;
 exports.useMethod = useMethod;
 exports.usePayment = usePayment;

package/dist/index.d.cts

@@ -477,6 +477,17 @@ declare global {
  * Error thrown when launch params cannot be retrieved.
  */
 //#endregion
+//#region ../bridge/src/link-interceptor.d.ts
+interface LinkInterceptorOptions {
+  /**
+   * Where to open intercepted links.
+   * - `external` (default): System browser or app handler
+   * - `internal`: Within the host app
+   * @default 'external'
+   */
+  openMode?: 'external' | 'internal';
+}
+//#endregion
 //#region ../bridge/src/request.d.ts
 interface RequestOptions {
   reqId?: string;
@@ -565,6 +576,12 @@ interface AlienProviderProps {
    * ```
    */
   autoReady?: boolean;
+  /**
+   * Whether to intercept external link clicks and route them through the
+   * bridge's `link:open` method. Same-origin links are unaffected.
+   * @default true
+   */
+  interceptLinks?: boolean;
 }
 /**
  * Provider component that initializes the Alien miniapp context.
@@ -585,7 +602,8 @@ interface AlienProviderProps {
  */
 declare function AlienProvider({
   children,
-  autoReady
+  autoReady,
+  interceptLinks
 }: AlienProviderProps): ReactNode;
 //#endregion
 //#region src/errors.d.ts
@@ -763,6 +781,21 @@ declare function useIsMethodSupported(method: MethodName): MethodSupportResult;
  */
 declare function useLaunchParams(): LaunchParams | undefined;
 //#endregion
+//#region src/hooks/useLinkInterceptor.d.ts
+/**
+ * Intercepts external link clicks and routes them through the bridge.
+ * Activates when the bridge is available, cleans up on unmount.
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   useLinkInterceptor();
+ *   return <a href="https://external.com">Opens via host app</a>;
+ * }
+ * ```
+ */
+declare function useLinkInterceptor(options?: LinkInterceptorOptions): void;
+//#endregion
 //#region src/hooks/useMethod.d.ts
 interface UseMethodExecuteResult<E extends EventName> {
   data: EventPayload<E> | undefined;
@@ -955,4 +988,4 @@ interface UsePaymentReturn {
  */
 declare function usePayment(options?: UsePaymentOptions): UsePaymentReturn;
 //#endregion
-export { AlienProvider, type AlienProviderProps, BridgeError, BridgeTimeoutError, BridgeUnavailableError, BridgeWindowUnavailableError, type ClipboardErrorCode, type EventName, type EventPayload, type MethodName, MethodNotSupportedError, type MethodPayload, type MethodSupportResult, type PaymentCallbacks, type PaymentErrorCode, type PaymentParams, type PaymentResponseStatus, type PaymentResult, type PaymentStatus, ReactSDKError, type RequestOptions, type UseClipboardOptions, type UseClipboardReturn, type UseMethodExecuteResult, type UseMethodOptions, type UsePaymentOptions, type UsePaymentReturn, type Version, getMethodMinVersion, isMethodSupported, send, useAlien, useClipboard, useEvent, useIsMethodSupported, useLaunchParams, useMethod, usePayment };
+export { AlienProvider, type AlienProviderProps, BridgeError, BridgeTimeoutError, BridgeUnavailableError, BridgeWindowUnavailableError, type ClipboardErrorCode, type EventName, type EventPayload, type LinkInterceptorOptions, type MethodName, MethodNotSupportedError, type MethodPayload, type MethodSupportResult, type PaymentCallbacks, type PaymentErrorCode, type PaymentParams, type PaymentResponseStatus, type PaymentResult, type PaymentStatus, ReactSDKError, type RequestOptions, type UseClipboardOptions, type UseClipboardReturn, type UseMethodExecuteResult, type UseMethodOptions, type UsePaymentOptions, type UsePaymentReturn, type Version, getMethodMinVersion, isMethodSupported, send, useAlien, useClipboard, useEvent, useIsMethodSupported, useLaunchParams, useLinkInterceptor, useMethod, usePayment };

package/dist/index.d.mts

@@ -477,6 +477,17 @@ declare global {
  * Error thrown when launch params cannot be retrieved.
  */
 //#endregion
+//#region ../bridge/src/link-interceptor.d.ts
+interface LinkInterceptorOptions {
+  /**
+   * Where to open intercepted links.
+   * - `external` (default): System browser or app handler
+   * - `internal`: Within the host app
+   * @default 'external'
+   */
+  openMode?: 'external' | 'internal';
+}
+//#endregion
 //#region ../bridge/src/request.d.ts
 interface RequestOptions {
   reqId?: string;
@@ -565,6 +576,12 @@ interface AlienProviderProps {
    * ```
    */
   autoReady?: boolean;
+  /**
+   * Whether to intercept external link clicks and route them through the
+   * bridge's `link:open` method. Same-origin links are unaffected.
+   * @default true
+   */
+  interceptLinks?: boolean;
 }
 /**
  * Provider component that initializes the Alien miniapp context.
@@ -585,7 +602,8 @@ interface AlienProviderProps {
  */
 declare function AlienProvider({
   children,
-  autoReady
+  autoReady,
+  interceptLinks
 }: AlienProviderProps): ReactNode;
 //#endregion
 //#region src/errors.d.ts
@@ -763,6 +781,21 @@ declare function useIsMethodSupported(method: MethodName): MethodSupportResult;
  */
 declare function useLaunchParams(): LaunchParams | undefined;
 //#endregion
+//#region src/hooks/useLinkInterceptor.d.ts
+/**
+ * Intercepts external link clicks and routes them through the bridge.
+ * Activates when the bridge is available, cleans up on unmount.
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   useLinkInterceptor();
+ *   return <a href="https://external.com">Opens via host app</a>;
+ * }
+ * ```
+ */
+declare function useLinkInterceptor(options?: LinkInterceptorOptions): void;
+//#endregion
 //#region src/hooks/useMethod.d.ts
 interface UseMethodExecuteResult<E extends EventName> {
   data: EventPayload<E> | undefined;
@@ -955,4 +988,4 @@ interface UsePaymentReturn {
  */
 declare function usePayment(options?: UsePaymentOptions): UsePaymentReturn;
 //#endregion
-export { AlienProvider, type AlienProviderProps, BridgeError, BridgeTimeoutError, BridgeUnavailableError, BridgeWindowUnavailableError, type ClipboardErrorCode, type EventName, type EventPayload, type MethodName, MethodNotSupportedError, type MethodPayload, type MethodSupportResult, type PaymentCallbacks, type PaymentErrorCode, type PaymentParams, type PaymentResponseStatus, type PaymentResult, type PaymentStatus, ReactSDKError, type RequestOptions, type UseClipboardOptions, type UseClipboardReturn, type UseMethodExecuteResult, type UseMethodOptions, type UsePaymentOptions, type UsePaymentReturn, type Version, getMethodMinVersion, isMethodSupported, send, useAlien, useClipboard, useEvent, useIsMethodSupported, useLaunchParams, useMethod, usePayment };
+export { AlienProvider, type AlienProviderProps, BridgeError, BridgeTimeoutError, BridgeUnavailableError, BridgeWindowUnavailableError, type ClipboardErrorCode, type EventName, type EventPayload, type LinkInterceptorOptions, type MethodName, MethodNotSupportedError, type MethodPayload, type MethodSupportResult, type PaymentCallbacks, type PaymentErrorCode, type PaymentParams, type PaymentResponseStatus, type PaymentResult, type PaymentStatus, ReactSDKError, type RequestOptions, type UseClipboardOptions, type UseClipboardReturn, type UseMethodExecuteResult, type UseMethodOptions, type UsePaymentOptions, type UsePaymentReturn, type Version, getMethodMinVersion, isMethodSupported, send, useAlien, useClipboard, useEvent, useIsMethodSupported, useLaunchParams, useLinkInterceptor, useMethod, usePayment };

package/dist/index.mjs

@@ -1,9 +1,10 @@
-import { BridgeError, BridgeTimeoutError, BridgeUnavailableError, BridgeWindowUnavailableError, getLaunchParams, isBridgeAvailable, on, request, send, send as send$1 } from "@alien_org/bridge";
+import { BridgeError, BridgeTimeoutError, BridgeUnavailableError, BridgeWindowUnavailableError, enableLinkInterceptor, getLaunchParams, isBridgeAvailable, on, request, send, send as send$1 } from "@alien_org/bridge";
 import { getMethodMinVersion, getMethodMinVersion as getMethodMinVersion$1, isMethodSupported, isMethodSupported as isMethodSupported$1 } from "@alien_org/contract";
-import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
+import { createContext, useCallback, useContext, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/context.tsx
+const useIsomorphicLayoutEffect$1 = typeof window !== "undefined" ? useLayoutEffect : useEffect;
 const AlienContext = createContext(null);
 /**
 * Provider component that initializes the Alien miniapp context.
@@ -22,28 +23,36 @@ const AlienContext = createContext(null);
 * }
 * ```
 */
-function AlienProvider({ children, autoReady = true }) {
+function AlienProvider({ children, autoReady = true, interceptLinks = true }) {
 	const readySent = useRef(false);
 	const ready = useCallback(() => {
 		if (readySent.current) return;
 		readySent.current = true;
 		if (isBridgeAvailable()) send$1("app:ready", {});
 	}, []);
-	const value = useMemo(() => {
+	const [value, setValue] = useState(() => ({
+		authToken: void 0,
+		contractVersion: void 0,
+		isBridgeAvailable: false,
+		ready
+	}));
+	useIsomorphicLayoutEffect$1(() => {
 		const launchParams = getLaunchParams();
-		return {
+		const bridgeAvailable = isBridgeAvailable();
+		setValue({
 			authToken: launchParams?.authToken,
 			contractVersion: launchParams?.contractVersion,
-			isBridgeAvailable: isBridgeAvailable(),
+			isBridgeAvailable: bridgeAvailable,
 			ready
-		};
+		});
+		if (!bridgeAvailable) console.warn("[@alien_org/react] Bridge is not available. Running in dev mode? The SDK will handle errors gracefully, but bridge communication will not work.");
 	}, [ready]);
-	useEffect(() => {
-		if (!value.isBridgeAvailable) console.warn("[@alien_org/react] Bridge is not available. Running in dev mode? The SDK will handle errors gracefully, but bridge communication will not work.");
-	}, [value.isBridgeAvailable]);
 	useEffect(() => {
 		if (autoReady) ready();
 	}, [autoReady, ready]);
+	useEffect(() => {
+		if (interceptLinks) return enableLinkInterceptor();
+	}, [interceptLinks]);
 	return /* @__PURE__ */ jsx(AlienContext.Provider, {
 		value,
 		children
@@ -259,6 +268,7 @@ function useIsMethodSupported(method) {
 
 //#endregion
 //#region src/hooks/useLaunchParams.ts
+const useIsomorphicLayoutEffect = typeof window !== "undefined" ? useLayoutEffect : useEffect;
 /**
 * Hook to get launch params.
 * Returns undefined if params unavailable (use mockLaunchParamsForDev in dev).
@@ -279,7 +289,34 @@ function useIsMethodSupported(method) {
 * ```
 */
 function useLaunchParams() {
-	return useMemo(() => getLaunchParams(), []);
+	const [params, setParams] = useState(void 0);
+	useIsomorphicLayoutEffect(() => {
+		setParams(getLaunchParams());
+	}, []);
+	return params;
+}
+
+//#endregion
+//#region src/hooks/useLinkInterceptor.ts
+/**
+* Intercepts external link clicks and routes them through the bridge.
+* Activates when the bridge is available, cleans up on unmount.
+*
+* @example
+* ```tsx
+* function App() {
+*   useLinkInterceptor();
+*   return <a href="https://external.com">Opens via host app</a>;
+* }
+* ```
+*/
+function useLinkInterceptor(options = {}) {
+	const { isBridgeAvailable: isBridgeAvailable$1 } = useAlien();
+	const { openMode } = options;
+	useEffect(() => {
+		if (!isBridgeAvailable$1) return;
+		return enableLinkInterceptor({ openMode });
+	}, [isBridgeAvailable$1, openMode]);
 }
 
 //#endregion
@@ -598,4 +635,4 @@ function usePayment(options = {}) {
 }
 
 //#endregion
-export { AlienProvider, BridgeError, BridgeTimeoutError, BridgeUnavailableError, BridgeWindowUnavailableError, MethodNotSupportedError, ReactSDKError, getMethodMinVersion, isMethodSupported, send, useAlien, useClipboard, useEvent, useIsMethodSupported, useLaunchParams, useMethod, usePayment };
+export { AlienProvider, BridgeError, BridgeTimeoutError, BridgeUnavailableError, BridgeWindowUnavailableError, MethodNotSupportedError, ReactSDKError, getMethodMinVersion, isMethodSupported, send, useAlien, useClipboard, useEvent, useIsMethodSupported, useLaunchParams, useLinkInterceptor, useMethod, usePayment };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alien_org/react",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -34,7 +34,7 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@alien_org/bridge": "0.2.1",
+    "@alien_org/bridge": "0.2.2",
     "@alien_org/contract": "0.2.1"
   },
   "peerDependencies": {