@dcl/hooks 0.0.0-20250211214929.commit-f590aa1 → 0.0.3-20250530143135.commit-48d49bb

package/README.md

@@ -19,6 +19,7 @@ npm install @dcl/hooks
 - `usePatchState`: Partial state updates for complex objects
 - `useAsyncEffect`: Async version of useEffect
 - `useAsyncMemo`: Async version of useMemo
+- `useShare`: Hook for sharing content using the Web Share API
 
 ## Examples
 
@@ -66,6 +67,38 @@ function BrowserInfo() {
 }
 ```
 
+### useShare
+
+```typescript
+import { useShare } from '@dcl/hooks'
+
+function ShareButton() {
+  const [share, shareState] = useShare()
+
+  const handleShare = async () => {
+    await share({
+      title: 'My Decentraland Experience',
+      text: 'Check out what I found in Decentraland!',
+      url: 'https://play.decentraland.org',
+      thumbnail: 'https://example.com/thumbnail.jpg' // optional
+    })
+  }
+
+  if (!shareState.isSupported) {
+    return <div>Sharing is not supported in this browser</div>
+  }
+
+  return (
+    <div>
+      <button onClick={handleShare} disabled={shareState.isSharing}>
+        {shareState.isSharing ? 'Sharing...' : 'Share'}
+      </button>
+      {shareState.error && <div>Error: {shareState.error.message}</div>}
+    </div>
+  )
+}
+```
+
 ## License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

package/cjs/hooks/index.d.ts

@@ -7,3 +7,4 @@ export { useAsyncTasks } from "./useAsyncTasks";
 export { usePatchState } from "./usePatchState";
 export { useAsyncEffect } from "./useAsyncEffect";
 export { useAsyncMemo, createAsyncMemoState } from "./useAsyncMemo";
+export { useShare } from "./useShare";

package/cjs/hooks/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createAsyncMemoState = exports.useAsyncMemo = exports.useAsyncEffect = exports.usePatchState = exports.useAsyncTasks = exports.useAsyncTask = exports.createAsyncStateState = exports.useAsyncState = exports.useAdvancedUserAgentData = void 0;
+exports.useShare = exports.createAsyncMemoState = exports.useAsyncMemo = exports.useAsyncEffect = exports.usePatchState = exports.useAsyncTasks = exports.useAsyncTask = exports.createAsyncStateState = exports.useAsyncState = exports.useAdvancedUserAgentData = void 0;
 // Hooks
 var useAdvancedUserAgentData_1 = require("./useAdvancedUserAgentData");
 Object.defineProperty(exports, "useAdvancedUserAgentData", { enumerable: true, get: function () { return useAdvancedUserAgentData_1.useAdvancedUserAgentData; } });
@@ -18,4 +18,6 @@ Object.defineProperty(exports, "useAsyncEffect", { enumerable: true, get: functi
 var useAsyncMemo_1 = require("./useAsyncMemo");
 Object.defineProperty(exports, "useAsyncMemo", { enumerable: true, get: function () { return useAsyncMemo_1.useAsyncMemo; } });
 Object.defineProperty(exports, "createAsyncMemoState", { enumerable: true, get: function () { return useAsyncMemo_1.createAsyncMemoState; } });
+var useShare_1 = require("./useShare");
+Object.defineProperty(exports, "useShare", { enumerable: true, get: function () { return useShare_1.useShare; } });
 //# sourceMappingURL=index.js.map

package/cjs/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":";;;AAIA,QAAQ;AACR,uEAAqE;AAA5D,oIAAA,wBAAwB,OAAA;AACjC,iDAAsE;AAA7D,8GAAA,aAAa,OAAA;AAAE,sHAAA,qBAAqB,OAAA;AAC7C,+CAA6C;AAApC,4GAAA,YAAY,OAAA;AACrB,iDAA+C;AAAtC,8GAAA,aAAa,OAAA;AACtB,iDAA+C;AAAtC,8GAAA,aAAa,OAAA;AACtB,mDAAiD;AAAxC,gHAAA,cAAc,OAAA;AACvB,+CAAmE;AAA1D,4GAAA,YAAY,OAAA;AAAE,oHAAA,oBAAoB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":";;;AAIA,QAAQ;AACR,uEAAqE;AAA5D,oIAAA,wBAAwB,OAAA;AACjC,iDAAsE;AAA7D,8GAAA,aAAa,OAAA;AAAE,sHAAA,qBAAqB,OAAA;AAC7C,+CAA6C;AAApC,4GAAA,YAAY,OAAA;AACrB,iDAA+C;AAAtC,8GAAA,aAAa,OAAA;AACtB,iDAA+C;AAAtC,8GAAA,aAAa,OAAA;AACtB,mDAAiD;AAAxC,gHAAA,cAAc,OAAA;AACvB,+CAAmE;AAA1D,4GAAA,YAAY,OAAA;AAAE,oHAAA,oBAAoB,OAAA;AAC3C,uCAAqC;AAA5B,oGAAA,QAAQ,OAAA"}

package/cjs/hooks/useShare.d.ts

@@ -0,0 +1,18 @@
+type DCLShareData = ShareData & {
+    thumbnail?: string;
+};
+type ShareState = {
+    data: DCLShareData | null;
+    isSupported: boolean;
+    isSharing: boolean;
+    error: Error | null;
+};
+declare const useShare: () => readonly [(shareData: DCLShareData) => Promise<void>, {
+    close: () => void;
+    data: DCLShareData | null;
+    isSupported: boolean;
+    isSharing: boolean;
+    error: Error | null;
+}];
+export { useShare };
+export type { DCLShareData, ShareState };

package/cjs/hooks/useShare.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useShare = void 0;
+const tslib_1 = require("tslib");
+const react_1 = require("react");
+const useShare = () => {
+    const [state, setState] = (0, react_1.useState)({
+        data: null,
+        isSupported: typeof navigator !== "undefined" && !!navigator.share,
+        isSharing: false,
+        error: null,
+    });
+    const share = (0, react_1.useCallback)((shareData) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+        if (!state.isSupported) {
+            setState((prev) => (Object.assign(Object.assign({}, prev), { data: shareData })));
+            return;
+        }
+        try {
+            setState((prev) => (Object.assign(Object.assign({}, prev), { isSharing: true, error: null })));
+            yield navigator.share(shareData);
+            setState((prev) => (Object.assign(Object.assign({}, prev), { isSharing: false, data: null })));
+        }
+        catch (error) {
+            setState((prev) => (Object.assign(Object.assign({}, prev), { isSharing: false, error: error instanceof Error ? error : new Error("Error al compartir"), data: shareData })));
+        }
+    }), [state.isSupported]);
+    const close = (0, react_1.useCallback)(() => {
+        setState((prev) => (Object.assign(Object.assign({}, prev), { data: null, error: null })));
+    }, []);
+    const shareState = (0, react_1.useMemo)(() => (Object.assign(Object.assign({}, state), { close })), [state, close]);
+    return [share, shareState];
+};
+exports.useShare = useShare;
+//# sourceMappingURL=useShare.js.map

package/cjs/hooks/useShare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useShare.js","sourceRoot":"","sources":["../../src/hooks/useShare.ts"],"names":[],"mappings":";;;;AAAA,iCAAsD;AAatD,MAAM,QAAQ,GAAG,GAAG,EAAE;IACpB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAa;QAC7C,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,OAAO,SAAS,KAAK,WAAW,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK;QAClE,SAAS,EAAE,KAAK;QAChB,KAAK,EAAE,IAAI;KACZ,CAAC,CAAA;IAEF,MAAM,KAAK,GAAG,IAAA,mBAAW,EACvB,CAAO,SAAuB,EAAE,EAAE;QAChC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YACvB,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iCAAM,IAAI,KAAE,IAAI,EAAE,SAAS,IAAG,CAAC,CAAA;YAClD,OAAM;QACR,CAAC;QAED,IAAI,CAAC;YACH,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iCAAM,IAAI,KAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,IAAG,CAAC,CAAA;YAC/D,MAAM,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;YAChC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iCAAM,IAAI,KAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,IAAG,CAAC,CAAA;QACjE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iCACd,IAAI,KACP,SAAS,EAAE,KAAK,EAChB,KAAK,EACH,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,EAClE,IAAI,EAAE,SAAS,IACf,CAAC,CAAA;QACL,CAAC;IACH,CAAC,CAAA,EACD,CAAC,KAAK,CAAC,WAAW,CAAC,CACpB,CAAA;IAED,MAAM,KAAK,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;QAC7B,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iCAAM,IAAI,KAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,IAAG,CAAC,CAAA;IAC5D,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,UAAU,GAAG,IAAA,eAAO,EACxB,GAAG,EAAE,CAAC,iCACD,KAAK,KACR,KAAK,IACL,EACF,CAAC,KAAK,EAAE,KAAK,CAAC,CACf,CAAA;IAED,OAAO,CAAC,KAAK,EAAE,UAAU,CAAU,CAAA;AACrC,CAAC,CAAA;AAEQ,4BAAQ"}

package/esm/hooks/index.d.ts

@@ -7,3 +7,4 @@ export { useAsyncTasks } from "./useAsyncTasks";
 export { usePatchState } from "./usePatchState";
 export { useAsyncEffect } from "./useAsyncEffect";
 export { useAsyncMemo, createAsyncMemoState } from "./useAsyncMemo";
+export { useShare } from "./useShare";

package/esm/hooks/index.js

@@ -6,4 +6,5 @@ export { useAsyncTasks } from "./useAsyncTasks";
 export { usePatchState } from "./usePatchState";
 export { useAsyncEffect } from "./useAsyncEffect";
 export { useAsyncMemo, createAsyncMemoState } from "./useAsyncMemo";
+export { useShare } from "./useShare";
 //# sourceMappingURL=index.js.map

package/esm/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAIA,QAAQ;AACR,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAA;AACrE,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAIA,QAAQ;AACR,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAA;AACrE,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA"}

package/esm/hooks/useShare.d.ts

@@ -0,0 +1,18 @@
+type DCLShareData = ShareData & {
+    thumbnail?: string;
+};
+type ShareState = {
+    data: DCLShareData | null;
+    isSupported: boolean;
+    isSharing: boolean;
+    error: Error | null;
+};
+declare const useShare: () => readonly [(shareData: DCLShareData) => Promise<void>, {
+    close: () => void;
+    data: DCLShareData | null;
+    isSupported: boolean;
+    isSharing: boolean;
+    error: Error | null;
+}];
+export { useShare };
+export type { DCLShareData, ShareState };

package/esm/hooks/useShare.js

@@ -0,0 +1,38 @@
+import { useCallback, useMemo, useState } from "react";
+const useShare = () => {
+    const [state, setState] = useState({
+        data: null,
+        isSupported: typeof navigator !== "undefined" && !!navigator.share,
+        isSharing: false,
+        error: null,
+    });
+    const share = useCallback(async (shareData) => {
+        if (!state.isSupported) {
+            setState((prev) => ({ ...prev, data: shareData }));
+            return;
+        }
+        try {
+            setState((prev) => ({ ...prev, isSharing: true, error: null }));
+            await navigator.share(shareData);
+            setState((prev) => ({ ...prev, isSharing: false, data: null }));
+        }
+        catch (error) {
+            setState((prev) => ({
+                ...prev,
+                isSharing: false,
+                error: error instanceof Error ? error : new Error("Error al compartir"),
+                data: shareData,
+            }));
+        }
+    }, [state.isSupported]);
+    const close = useCallback(() => {
+        setState((prev) => ({ ...prev, data: null, error: null }));
+    }, []);
+    const shareState = useMemo(() => ({
+        ...state,
+        close,
+    }), [state, close]);
+    return [share, shareState];
+};
+export { useShare };
+//# sourceMappingURL=useShare.js.map

package/esm/hooks/useShare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useShare.js","sourceRoot":"","sources":["../../src/hooks/useShare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAatD,MAAM,QAAQ,GAAG,GAAG,EAAE;IACpB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAa;QAC7C,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,OAAO,SAAS,KAAK,WAAW,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK;QAClE,SAAS,EAAE,KAAK;QAChB,KAAK,EAAE,IAAI;KACZ,CAAC,CAAA;IAEF,MAAM,KAAK,GAAG,WAAW,CACvB,KAAK,EAAE,SAAuB,EAAE,EAAE;QAChC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YACvB,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAA;YAClD,OAAM;QACR,CAAC;QAED,IAAI,CAAC;YACH,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;YAC/D,MAAM,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;YAChC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QACjE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAClB,GAAG,IAAI;gBACP,SAAS,EAAE,KAAK;gBAChB,KAAK,EACH,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC;gBAClE,IAAI,EAAE,SAAS;aAChB,CAAC,CAAC,CAAA;QACL,CAAC;IACH,CAAC,EACD,CAAC,KAAK,CAAC,WAAW,CAAC,CACpB,CAAA;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAC5D,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,UAAU,GAAG,OAAO,CACxB,GAAG,EAAE,CAAC,CAAC;QACL,GAAG,KAAK;QACR,KAAK;KACN,CAAC,EACF,CAAC,KAAK,EAAE,KAAK,CAAC,CACf,CAAA;IAED,OAAO,CAAC,KAAK,EAAE,UAAU,CAAU,CAAA;AACrC,CAAC,CAAA;AAED,OAAO,EAAE,QAAQ,EAAE,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcl/hooks",
-  "version": "0.0.0-20250211214929.commit-f590aa1",
+  "version": "0.0.3-20250530143135.commit-48d49bb",
   "main": "cjs/index.js",
   "module": "esm/index.js",
   "exports": {
@@ -78,5 +78,5 @@
       "^src/(.*)$": "<rootDir>/src/$1"
     }
   },
-  "commit": "f590aa114bfb9fd1c27b7045434c6ea9ef30ca11"
+  "commit": "48d49bb011054675ca9cca7b5634689d97b18df3"
 }