@alien_org/react 0.1.2 → 0.1.3

package/dist/index.cjs

@@ -91,6 +91,84 @@ function useAlien() {
 	return context;
 }
 
+//#endregion
+//#region src/hooks/useClipboard.ts
+/**
+* Hook for clipboard operations.
+*
+* @example
+* ```tsx
+* function ClipboardDemo() {
+*   const { writeText, readText, isReading, errorCode, supported } = useClipboard();
+*
+*   if (!supported) return null;
+*
+*   return (
+*     <>
+*       <button onClick={() => writeText('Hello!')}>Copy</button>
+*       <button
+*         onClick={async () => {
+*           const text = await readText();
+*           if (text !== null) console.log('Pasted:', text);
+*         }}
+*         disabled={isReading}
+*       >
+*         Paste
+*       </button>
+*       {errorCode && <span>Error: {errorCode}</span>}
+*     </>
+*   );
+* }
+* ```
+*/
+function useClipboard(options = {}) {
+	const { timeout = 5e3 } = options;
+	const { contractVersion, isBridgeAvailable: isBridgeAvailable$1 } = useAlien();
+	const [isReading, setIsReading] = (0, react.useState)(false);
+	const [errorCode, setErrorCode] = (0, react.useState)(null);
+	const supported = contractVersion ? (0, _alien_org_contract.isMethodSupported)("clipboard:write", contractVersion) && (0, _alien_org_contract.isMethodSupported)("clipboard:read", contractVersion) : true;
+	const writeText = (0, react.useCallback)((text) => {
+		if (!isBridgeAvailable$1) return;
+		if (contractVersion && !(0, _alien_org_contract.isMethodSupported)("clipboard:write", contractVersion)) return;
+		(0, _alien_org_bridge.send)("clipboard:write", { text });
+	}, [isBridgeAvailable$1, contractVersion]);
+	const readText = (0, react.useCallback)(async () => {
+		if (!isBridgeAvailable$1) return null;
+		if (contractVersion && !(0, _alien_org_contract.isMethodSupported)("clipboard:read", contractVersion)) return null;
+		setIsReading(true);
+		setErrorCode(null);
+		try {
+			const response = await (0, _alien_org_bridge.request)("clipboard:read", {}, "clipboard:response", { timeout });
+			if (response.errorCode) {
+				setErrorCode(response.errorCode);
+				return null;
+			}
+			return response.text;
+		} catch {
+			return null;
+		} finally {
+			setIsReading(false);
+		}
+	}, [
+		isBridgeAvailable$1,
+		contractVersion,
+		timeout
+	]);
+	return (0, react.useMemo)(() => ({
+		writeText,
+		readText,
+		isReading,
+		errorCode,
+		supported
+	}), [
+		writeText,
+		readText,
+		isReading,
+		errorCode,
+		supported
+	]);
+}
+
 //#endregion
 //#region src/hooks/useEvent.ts
 /**
@@ -539,6 +617,7 @@ Object.defineProperty(exports, 'send', {
   }
 });
 exports.useAlien = useAlien;
+exports.useClipboard = useClipboard;
 exports.useEvent = useEvent;
 exports.useIsMethodSupported = useIsMethodSupported;
 exports.useLaunchParams = useLaunchParams;

package/dist/index.d.cts

@@ -479,6 +479,58 @@ declare class MethodNotSupportedError extends ReactSDKError {
  */
 declare function useAlien(): AlienContextValue;
 //#endregion
+//#region src/hooks/useClipboard.d.ts
+/** Clipboard error codes from the host app. */
+type ClipboardErrorCode = 'permission_denied' | 'unavailable';
+interface UseClipboardOptions {
+  /**
+   * Timeout for clipboard read in milliseconds.
+   * @default 5000
+   */
+  timeout?: number;
+}
+interface UseClipboardReturn {
+  /** Write text to clipboard. Fire-and-forget. */
+  writeText: (text: string) => void;
+  /** Read text from clipboard. Returns text or null on failure. */
+  readText: () => Promise<string | null>;
+  /** Whether a read operation is in progress. */
+  isReading: boolean;
+  /** Error code from the last failed read operation. */
+  errorCode: ClipboardErrorCode | null;
+  /** Whether clipboard methods are supported by the host app. */
+  supported: boolean;
+}
+/**
+ * Hook for clipboard operations.
+ *
+ * @example
+ * ```tsx
+ * function ClipboardDemo() {
+ *   const { writeText, readText, isReading, errorCode, supported } = useClipboard();
+ *
+ *   if (!supported) return null;
+ *
+ *   return (
+ *     <>
+ *       <button onClick={() => writeText('Hello!')}>Copy</button>
+ *       <button
+ *         onClick={async () => {
+ *           const text = await readText();
+ *           if (text !== null) console.log('Pasted:', text);
+ *         }}
+ *         disabled={isReading}
+ *       >
+ *         Paste
+ *       </button>
+ *       {errorCode && <span>Error: {errorCode}</span>}
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+declare function useClipboard(options?: UseClipboardOptions): UseClipboardReturn;
+//#endregion
 //#region src/hooks/useEvent.d.ts
 type EventCallback<E extends EventName> = (payload: EventPayload<E>) => void;
 /**
@@ -762,4 +814,4 @@ interface UsePaymentReturn {
  */
 declare function usePayment(options?: UsePaymentOptions): UsePaymentReturn;
 //#endregion
-export { AlienProvider, type AlienProviderProps, BridgeError, BridgeTimeoutError, BridgeUnavailableError, BridgeWindowUnavailableError, 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 UseMethodExecuteResult, type UseMethodOptions, type UsePaymentOptions, type UsePaymentReturn, type Version, getMethodMinVersion, isMethodSupported, send, useAlien, useEvent, useIsMethodSupported, useLaunchParams, useMethod, usePayment };
+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 };

package/dist/index.d.mts

@@ -479,6 +479,58 @@ declare class MethodNotSupportedError extends ReactSDKError {
  */
 declare function useAlien(): AlienContextValue;
 //#endregion
+//#region src/hooks/useClipboard.d.ts
+/** Clipboard error codes from the host app. */
+type ClipboardErrorCode = 'permission_denied' | 'unavailable';
+interface UseClipboardOptions {
+  /**
+   * Timeout for clipboard read in milliseconds.
+   * @default 5000
+   */
+  timeout?: number;
+}
+interface UseClipboardReturn {
+  /** Write text to clipboard. Fire-and-forget. */
+  writeText: (text: string) => void;
+  /** Read text from clipboard. Returns text or null on failure. */
+  readText: () => Promise<string | null>;
+  /** Whether a read operation is in progress. */
+  isReading: boolean;
+  /** Error code from the last failed read operation. */
+  errorCode: ClipboardErrorCode | null;
+  /** Whether clipboard methods are supported by the host app. */
+  supported: boolean;
+}
+/**
+ * Hook for clipboard operations.
+ *
+ * @example
+ * ```tsx
+ * function ClipboardDemo() {
+ *   const { writeText, readText, isReading, errorCode, supported } = useClipboard();
+ *
+ *   if (!supported) return null;
+ *
+ *   return (
+ *     <>
+ *       <button onClick={() => writeText('Hello!')}>Copy</button>
+ *       <button
+ *         onClick={async () => {
+ *           const text = await readText();
+ *           if (text !== null) console.log('Pasted:', text);
+ *         }}
+ *         disabled={isReading}
+ *       >
+ *         Paste
+ *       </button>
+ *       {errorCode && <span>Error: {errorCode}</span>}
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+declare function useClipboard(options?: UseClipboardOptions): UseClipboardReturn;
+//#endregion
 //#region src/hooks/useEvent.d.ts
 type EventCallback<E extends EventName> = (payload: EventPayload<E>) => void;
 /**
@@ -762,4 +814,4 @@ interface UsePaymentReturn {
  */
 declare function usePayment(options?: UsePaymentOptions): UsePaymentReturn;
 //#endregion
-export { AlienProvider, type AlienProviderProps, BridgeError, BridgeTimeoutError, BridgeUnavailableError, BridgeWindowUnavailableError, 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 UseMethodExecuteResult, type UseMethodOptions, type UsePaymentOptions, type UsePaymentReturn, type Version, getMethodMinVersion, isMethodSupported, send, useAlien, useEvent, useIsMethodSupported, useLaunchParams, useMethod, usePayment };
+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 };

package/dist/index.mjs

@@ -91,6 +91,84 @@ function useAlien() {
 	return context;
 }
 
+//#endregion
+//#region src/hooks/useClipboard.ts
+/**
+* Hook for clipboard operations.
+*
+* @example
+* ```tsx
+* function ClipboardDemo() {
+*   const { writeText, readText, isReading, errorCode, supported } = useClipboard();
+*
+*   if (!supported) return null;
+*
+*   return (
+*     <>
+*       <button onClick={() => writeText('Hello!')}>Copy</button>
+*       <button
+*         onClick={async () => {
+*           const text = await readText();
+*           if (text !== null) console.log('Pasted:', text);
+*         }}
+*         disabled={isReading}
+*       >
+*         Paste
+*       </button>
+*       {errorCode && <span>Error: {errorCode}</span>}
+*     </>
+*   );
+* }
+* ```
+*/
+function useClipboard(options = {}) {
+	const { timeout = 5e3 } = options;
+	const { contractVersion, isBridgeAvailable: isBridgeAvailable$1 } = useAlien();
+	const [isReading, setIsReading] = useState(false);
+	const [errorCode, setErrorCode] = useState(null);
+	const supported = contractVersion ? isMethodSupported$1("clipboard:write", contractVersion) && isMethodSupported$1("clipboard:read", contractVersion) : true;
+	const writeText = useCallback((text) => {
+		if (!isBridgeAvailable$1) return;
+		if (contractVersion && !isMethodSupported$1("clipboard:write", contractVersion)) return;
+		send$1("clipboard:write", { text });
+	}, [isBridgeAvailable$1, contractVersion]);
+	const readText = useCallback(async () => {
+		if (!isBridgeAvailable$1) return null;
+		if (contractVersion && !isMethodSupported$1("clipboard:read", contractVersion)) return null;
+		setIsReading(true);
+		setErrorCode(null);
+		try {
+			const response = await request("clipboard:read", {}, "clipboard:response", { timeout });
+			if (response.errorCode) {
+				setErrorCode(response.errorCode);
+				return null;
+			}
+			return response.text;
+		} catch {
+			return null;
+		} finally {
+			setIsReading(false);
+		}
+	}, [
+		isBridgeAvailable$1,
+		contractVersion,
+		timeout
+	]);
+	return useMemo(() => ({
+		writeText,
+		readText,
+		isReading,
+		errorCode,
+		supported
+	}), [
+		writeText,
+		readText,
+		isReading,
+		errorCode,
+		supported
+	]);
+}
+
 //#endregion
 //#region src/hooks/useEvent.ts
 /**
@@ -513,4 +591,4 @@ function usePayment(options = {}) {
 }
 
 //#endregion
-export { AlienProvider, BridgeError, BridgeTimeoutError, BridgeUnavailableError, BridgeWindowUnavailableError, MethodNotSupportedError, ReactSDKError, getMethodMinVersion, isMethodSupported, send, useAlien, useEvent, useIsMethodSupported, useLaunchParams, useMethod, usePayment };
+export { AlienProvider, BridgeError, BridgeTimeoutError, BridgeUnavailableError, BridgeWindowUnavailableError, MethodNotSupportedError, ReactSDKError, getMethodMinVersion, isMethodSupported, send, useAlien, useClipboard, useEvent, useIsMethodSupported, useLaunchParams, useMethod, usePayment };

package/package.json

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