@shopify/shop-minis-react 0.6.0 → 0.6.1

package/dist/_virtual/index4.js

@@ -1,5 +1,5 @@
-var e = { exports: {} };
+var r = {};
 export {
-  e as __module
+  r as __exports
 };
 //# sourceMappingURL=index4.js.map

package/dist/_virtual/index5.js

@@ -1,6 +1,5 @@
-import { __require as r } from "../shop-minis-react/node_modules/.pnpm/@xmldom_xmldom@0.8.10/node_modules/@xmldom/xmldom/lib/index.js";
-var i = r();
+var e = { exports: {} };
 export {
-  i as l
+  e as __module
 };
 //# sourceMappingURL=index5.js.map

package/dist/_virtual/index5.js.map

@@ -1 +1 @@
-{"version":3,"file":"index5.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}
+{"version":3,"file":"index5.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/index6.js

@@ -1,5 +1,6 @@
-var r = {};
+import { __require as r } from "../shop-minis-react/node_modules/.pnpm/@xmldom_xmldom@0.8.10/node_modules/@xmldom/xmldom/lib/index.js";
+var i = r();
 export {
-  r as __exports
+  i as l
 };
 //# sourceMappingURL=index6.js.map

package/dist/_virtual/index6.js.map

@@ -1 +1 @@
-{"version":3,"file":"index6.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}
+{"version":3,"file":"index6.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/index.js

@@ -2,12 +2,12 @@ import { DATA_NAVIGATION_TYPE_ATTRIBUTE as o, NAVIGATION_TYPES as t } from "./ty
 import { MinisContainer as i } from "./components/MinisContainer.js";
 import { AddToCartButton as n } from "./components/commerce/add-to-cart.js";
 import { BuyNowButton as s } from "./components/commerce/buy-now.js";
-import { ProductCard as u, ProductCardBadge as f, ProductCardContainer as x, ProductCardFavoriteButton as c, ProductCardImage as d, ProductCardImageContainer as C, ProductCardInfo as g, ProductCardPrice as S, ProductCardReviewStars as A, ProductCardTitle as D } from "./components/commerce/product-card.js";
+import { ProductCard as u, ProductCardBadge as f, ProductCardContainer as x, ProductCardFavoriteButton as c, ProductCardImage as d, ProductCardImageContainer as C, ProductCardInfo as g, ProductCardPrice as S, ProductCardReviewStars as D, ProductCardTitle as A } from "./components/commerce/product-card.js";
 import { ProductLink as T } from "./components/commerce/product-link.js";
 import { MerchantCard as I, MerchantCardContainer as R, MerchantCardHeader as v, MerchantCardInfo as w, MerchantCardName as B, MerchantCardRating as E } from "./components/commerce/merchant-card.js";
 import { ProductCardSkeleton as F } from "./components/commerce/product-card-skeleton.js";
-import { MerchantCardSkeleton as L } from "./components/commerce/merchant-card-skeleton.js";
-import { QuantitySelector as N } from "./components/commerce/quantity-selector.js";
+import { MerchantCardSkeleton as b } from "./components/commerce/merchant-card-skeleton.js";
+import { QuantitySelector as k } from "./components/commerce/quantity-selector.js";
 import { Search as O, SearchInput as _, SearchProvider as y, SearchResultsList as G } from "./components/commerce/search.js";
 import { FavoriteButton as V } from "./components/commerce/favorite-button.js";
 import { ImageContentWrapper as W } from "./components/content/image-content-wrapper.js";
@@ -24,20 +24,20 @@ import { VideoPlayer as lr } from "./components/atoms/video-player.js";
 import { TextInput as fr } from "./components/atoms/text-input.js";
 import { ContentWrapper as cr } from "./components/atoms/content-wrapper.js";
 import { ProductVariantPrice as Cr } from "./components/atoms/product-variant-price.js";
-import { Accordion as Sr, AccordionContent as Ar, AccordionItem as Dr, AccordionTrigger as Pr } from "./components/ui/accordion.js";
+import { Accordion as Sr, AccordionContent as Dr, AccordionItem as Ar, AccordionTrigger as Pr } from "./components/ui/accordion.js";
 import { Alert as hr, AlertDescription as Ir, AlertTitle as Rr } from "./components/ui/alert.js";
-import { AlertDialog as wr, AlertDialogAction as Br, AlertDialogCancel as Er, AlertDialogContent as Mr, AlertDialogDescription as Fr, AlertDialogFooter as Ur, AlertDialogHeader as Lr, AlertDialogOverlay as br, AlertDialogPortal as Nr, AlertDialogTitle as kr, AlertDialogTrigger as Or } from "./components/ui/alert-dialog.js";
+import { AlertDialog as wr, AlertDialogAction as Br, AlertDialogCancel as Er, AlertDialogContent as Mr, AlertDialogDescription as Fr, AlertDialogFooter as Ur, AlertDialogHeader as br, AlertDialogOverlay as Lr, AlertDialogPortal as kr, AlertDialogTitle as Nr, AlertDialogTrigger as Or } from "./components/ui/alert-dialog.js";
 import { Avatar as yr, AvatarFallback as Gr, AvatarImage as Hr } from "./components/ui/avatar.js";
 import { Badge as zr, badgeVariants as Wr } from "./components/ui/badge.js";
 import { Card as qr, CardAction as Kr, CardContent as Qr, CardDescription as Zr, CardFooter as jr, CardHeader as Jr, CardTitle as Xr } from "./components/ui/card.js";
 import { Carousel as re, CarouselContent as ee, CarouselItem as oe, CarouselNext as te, CarouselPrevious as ae } from "./components/ui/carousel.js";
 import { Checkbox as pe } from "./components/ui/checkbox.js";
 import { Dialog as me, DialogClose as se, DialogContent as le, DialogDescription as ue, DialogFooter as fe, DialogHeader as xe, DialogOverlay as ce, DialogPortal as de, DialogTitle as Ce, DialogTrigger as ge } from "./components/ui/dialog.js";
-import { Drawer as Ae, DrawerClose as De, DrawerContent as Pe, DrawerDescription as Te, DrawerFooter as he, DrawerHeader as Ie, DrawerOverlay as Re, DrawerPortal as ve, DrawerTitle as we, DrawerTrigger as Be } from "./components/ui/drawer.js";
+import { Drawer as De, DrawerClose as Ae, DrawerContent as Pe, DrawerDescription as Te, DrawerFooter as he, DrawerHeader as Ie, DrawerOverlay as Re, DrawerPortal as ve, DrawerTitle as we, DrawerTrigger as Be } from "./components/ui/drawer.js";
 import { Input as Me } from "./components/ui/input.js";
 import { Label as Ue } from "./components/ui/label.js";
-import { Progress as be } from "./components/ui/progress.js";
-import { RadioGroup as ke, RadioGroupItem as Oe } from "./components/ui/radio-group.js";
+import { Progress as Le } from "./components/ui/progress.js";
+import { RadioGroup as Ne, RadioGroupItem as Oe } from "./components/ui/radio-group.js";
 import { ResizableHandle as ye, ResizablePanel as Ge, ResizablePanelGroup as He } from "./components/ui/resizable.js";
 import { ScrollArea as ze, ScrollBar as We } from "./components/ui/scroll-area.js";
 import { Select as qe, SelectContent as Ke, SelectGroup as Qe, SelectItem as Ze, SelectLabel as je, SelectScrollDownButton as Je, SelectScrollUpButton as Xe, SelectSeparator as $e, SelectTrigger as ro, SelectValue as eo } from "./components/ui/select.js";
@@ -45,15 +45,15 @@ import { Separator as to } from "./components/ui/separator.js";
 import { Sheet as io, SheetClose as po, SheetContent as no, SheetDescription as mo, SheetFooter as so, SheetHeader as lo, SheetTitle as uo, SheetTrigger as fo } from "./components/ui/sheet.js";
 import { Toaster as co } from "./components/ui/sonner.js";
 import { toast as go } from "./shop-minis-react/node_modules/.pnpm/sonner@2.0.5_react-dom@19.1.0_react@19.1.0__react@19.1.0/node_modules/sonner/dist/index.js";
-import { Skeleton as Ao } from "./components/ui/skeleton.js";
+import { Skeleton as Do } from "./components/ui/skeleton.js";
 import { useRecentProducts as Po } from "./hooks/user/useRecentProducts.js";
 import { useRecentShops as ho } from "./hooks/user/useRecentShops.js";
 import { useSavedProducts as Ro } from "./hooks/user/useSavedProducts.js";
 import { useSavedProductsActions as wo } from "./hooks/user/useSavedProductsActions.js";
 import { useFollowedShops as Eo } from "./hooks/user/useFollowedShops.js";
 import { useFollowedShopsActions as Fo } from "./hooks/user/useFollowedShopsActions.js";
-import { useCurrentUser as Lo } from "./hooks/user/useCurrentUser.js";
-import { useOrders as No } from "./hooks/user/useOrders.js";
+import { useCurrentUser as bo } from "./hooks/user/useCurrentUser.js";
+import { useOrders as ko } from "./hooks/user/useOrders.js";
 import { useBuyerAttributes as Oo } from "./hooks/user/useBuyerAttributes.js";
 import { useGenerateUserToken as yo } from "./hooks/user/useGenerateUserToken.js";
 import { useProductListActions as Ho } from "./hooks/product/useProductListActions.js";
@@ -72,15 +72,15 @@ import { useSecureStorage as ut } from "./hooks/storage/useSecureStorage.js";
 import { useImageUpload as xt } from "./hooks/storage/useImageUpload.js";
 import { useShopNavigation as dt } from "./hooks/navigation/useShopNavigation.js";
 import { useCloseMini as gt } from "./hooks/navigation/useCloseMini.js";
-import { useDeeplink as At } from "./hooks/navigation/useDeeplink.js";
+import { useDeeplink as Dt } from "./hooks/navigation/useDeeplink.js";
 import { useNavigateWithTransition as Pt } from "./hooks/navigation/useNavigateWithTransition.js";
 import { useShop as ht } from "./hooks/shop/useShop.js";
 import { useRecommendedShops as Rt } from "./hooks/shop/useRecommendedShops.js";
 import { useCreateImageContent as wt } from "./hooks/content/useCreateImageContent.js";
 import { useErrorToast as Et } from "./hooks/util/useErrorToast.js";
 import { useErrorScreen as Ft } from "./hooks/util/useErrorScreen.js";
-import { useShare as Lt } from "./hooks/util/useShare.js";
-import { useImagePicker as Nt } from "./hooks/util/useImagePicker.js";
+import { useShare as bt } from "./hooks/util/useShare.js";
+import { useImagePicker as kt } from "./hooks/util/useImagePicker.js";
 import { useKeyboardAvoidingView as Ot } from "./hooks/util/useKeyboardAvoidingView.js";
 import { useRequestPermissions as yt } from "./hooks/util/useRequestPermissions.js";
 import { useOnMiniFocus as Ht } from "./hooks/events/useOnMiniFocus.js";
@@ -88,19 +88,20 @@ import { useOnMiniBlur as zt } from "./hooks/events/useOnMiniBlur.js";
 import { useOnMiniClose as Yt } from "./hooks/events/useOnMiniClose.js";
 import { useOnAppStateChange as Kt } from "./hooks/events/useOnAppStateChange.js";
 import { useOnNavigateBack as Zt } from "./hooks/events/useOnNavigateBack.js";
-import { MiniEntityNotFoundError as Jt, MiniError as Xt, MiniNetworkError as $t, formatError as ra } from "./utils/errors.js";
-import { extractBrandTheme as oa, formatReviewCount as ta, getFeaturedImages as aa, normalizeRating as ia } from "./utils/merchant-card.js";
-import { parseUrl as na } from "./utils/parseUrl.js";
-import { dataURLToBlob as sa, fileToDataUri as la, getResizedImageUrl as ua, getThumbhashBlobURL as fa, getThumbhashDataURL as xa } from "./utils/image.js";
-import { formatMoney as da } from "./utils/formatMoney.js";
-import { UserState as ga, UserTokenGenerateUserErrorCode as Sa } from "./shop-minis-platform/src/types/user.js";
-import { ContentCreateUserErrorCode as Da, MinisContentStatus as Pa } from "./shop-minis-platform/src/types/content.js";
-import { Social as ha } from "./shop-minis-platform/src/types/share.js";
-import { DATA_FETCHING_DEFAULT_FETCH_POLICY as Ra, DATA_FETCHING_DEFAULT_PAGE_SIZE as va } from "./shop-minis-platform/src/constants.js";
+import { buildDeeplinkUrl as Jt } from "./utils/buildDeeplinkUrl.js";
+import { MiniEntityNotFoundError as $t, MiniError as ra, MiniNetworkError as ea, formatError as oa } from "./utils/errors.js";
+import { extractBrandTheme as aa, formatReviewCount as ia, getFeaturedImages as pa, normalizeRating as na } from "./utils/merchant-card.js";
+import { parseUrl as sa } from "./utils/parseUrl.js";
+import { dataURLToBlob as ua, fileToDataUri as fa, getResizedImageUrl as xa, getThumbhashBlobURL as ca, getThumbhashDataURL as da } from "./utils/image.js";
+import { formatMoney as ga } from "./utils/formatMoney.js";
+import { UserState as Da, UserTokenGenerateUserErrorCode as Aa } from "./shop-minis-platform/src/types/user.js";
+import { ContentCreateUserErrorCode as Ta, MinisContentStatus as ha } from "./shop-minis-platform/src/types/content.js";
+import { Social as Ra } from "./shop-minis-platform/src/types/share.js";
+import { DATA_FETCHING_DEFAULT_FETCH_POLICY as wa, DATA_FETCHING_DEFAULT_PAGE_SIZE as Ba } from "./shop-minis-platform/src/constants.js";
 export {
   Sr as Accordion,
-  Ar as AccordionContent,
-  Dr as AccordionItem,
+  Dr as AccordionContent,
+  Ar as AccordionItem,
   Pr as AccordionTrigger,
   n as AddToCartButton,
   hr as Alert,
@@ -112,10 +113,10 @@ export {
   Mr as AlertDialogContent,
   Fr as AlertDialogDescription,
   Ur as AlertDialogFooter,
-  Lr as AlertDialogHeader,
-  br as AlertDialogOverlay,
-  Nr as AlertDialogPortal,
-  kr as AlertDialogTitle,
+  br as AlertDialogHeader,
+  Lr as AlertDialogOverlay,
+  kr as AlertDialogPortal,
+  Nr as AlertDialogTitle,
   Or as AlertDialogTrigger,
   Rr as AlertTitle,
   yr as Avatar,
@@ -137,10 +138,10 @@ export {
   te as CarouselNext,
   ae as CarouselPrevious,
   pe as Checkbox,
-  Da as ContentCreateUserErrorCode,
+  Ta as ContentCreateUserErrorCode,
   cr as ContentWrapper,
-  Ra as DATA_FETCHING_DEFAULT_FETCH_POLICY,
-  va as DATA_FETCHING_DEFAULT_PAGE_SIZE,
+  wa as DATA_FETCHING_DEFAULT_FETCH_POLICY,
+  Ba as DATA_FETCHING_DEFAULT_PAGE_SIZE,
   o as DATA_NAVIGATION_TYPE_ATTRIBUTE,
   me as Dialog,
   se as DialogClose,
@@ -152,8 +153,8 @@ export {
   de as DialogPortal,
   Ce as DialogTitle,
   ge as DialogTrigger,
-  Ae as Drawer,
-  De as DrawerClose,
+  De as Drawer,
+  Ae as DrawerClose,
   Pe as DrawerContent,
   Te as DrawerDescription,
   he as DrawerFooter,
@@ -176,12 +177,12 @@ export {
   w as MerchantCardInfo,
   B as MerchantCardName,
   E as MerchantCardRating,
-  L as MerchantCardSkeleton,
-  Jt as MiniEntityNotFoundError,
-  Xt as MiniError,
-  $t as MiniNetworkError,
+  b as MerchantCardSkeleton,
+  $t as MiniEntityNotFoundError,
+  ra as MiniError,
+  ea as MiniNetworkError,
   i as MinisContainer,
-  Pa as MinisContentStatus,
+  ha as MinisContentStatus,
   q as MinisRouter,
   t as NAVIGATION_TYPES,
   u as ProductCard,
@@ -192,14 +193,14 @@ export {
   C as ProductCardImageContainer,
   g as ProductCardInfo,
   S as ProductCardPrice,
-  A as ProductCardReviewStars,
+  D as ProductCardReviewStars,
   F as ProductCardSkeleton,
-  D as ProductCardTitle,
+  A as ProductCardTitle,
   T as ProductLink,
   Cr as ProductVariantPrice,
-  be as Progress,
-  N as QuantitySelector,
-  ke as RadioGroup,
+  Le as Progress,
+  k as QuantitySelector,
+  Ne as RadioGroup,
   Oe as RadioGroupItem,
   ye as ResizableHandle,
   Ge as ResizablePanel,
@@ -229,41 +230,42 @@ export {
   lo as SheetHeader,
   uo as SheetTitle,
   fo as SheetTrigger,
-  Ao as Skeleton,
-  ha as Social,
+  Do as Skeleton,
+  Ra as Social,
   fr as TextInput,
   co as Toaster,
   or as Touchable,
   Q as TransitionLink,
-  ga as UserState,
-  Sa as UserTokenGenerateUserErrorCode,
+  Da as UserState,
+  Aa as UserTokenGenerateUserErrorCode,
   lr as VideoPlayer,
   Wr as badgeVariants,
-  sa as dataURLToBlob,
-  oa as extractBrandTheme,
-  la as fileToDataUri,
-  ra as formatError,
-  da as formatMoney,
-  ta as formatReviewCount,
-  aa as getFeaturedImages,
-  ua as getResizedImageUrl,
-  fa as getThumbhashBlobURL,
-  xa as getThumbhashDataURL,
-  ia as normalizeRating,
-  na as parseUrl,
+  Jt as buildDeeplinkUrl,
+  ua as dataURLToBlob,
+  aa as extractBrandTheme,
+  fa as fileToDataUri,
+  oa as formatError,
+  ga as formatMoney,
+  ia as formatReviewCount,
+  pa as getFeaturedImages,
+  xa as getResizedImageUrl,
+  ca as getThumbhashBlobURL,
+  da as getThumbhashDataURL,
+  na as normalizeRating,
+  sa as parseUrl,
   go as toast,
   st as useAsyncStorage,
   Oo as useBuyerAttributes,
   gt as useCloseMini,
   wt as useCreateImageContent,
-  Lo as useCurrentUser,
-  At as useDeeplink,
+  bo as useCurrentUser,
+  Dt as useDeeplink,
   Ft as useErrorScreen,
   Et as useErrorToast,
   Eo as useFollowedShops,
   Fo as useFollowedShopsActions,
   yo as useGenerateUserToken,
-  Nt as useImagePicker,
+  kt as useImagePicker,
   xt as useImageUpload,
   Ot as useKeyboardAvoidingView,
   Pt as useNavigateWithTransition,
@@ -272,7 +274,7 @@ export {
   Yt as useOnMiniClose,
   Ht as useOnMiniFocus,
   Zt as useOnNavigateBack,
-  No as useOrders,
+  ko as useOrders,
   nt as usePopularProducts,
   Ko as useProduct,
   Yo as useProductList,
@@ -291,7 +293,7 @@ export {
   Ro as useSavedProducts,
   wo as useSavedProductsActions,
   ut as useSecureStorage,
-  Lt as useShare,
+  bt as useShare,
   ht as useShop,
   dt as useShopNavigation
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/shop-minis-react/node_modules/.pnpm/@videojs_xhr@2.7.0/node_modules/@videojs/xhr/lib/index.js

@@ -1,4 +1,4 @@
-import { __module as q } from "../../../../../../../../_virtual/index4.js";
+import { __module as q } from "../../../../../../../../_virtual/index5.js";
 import { __require as F } from "../../../../../global@4.4.0/node_modules/global/window.js";
 import { __require as N } from "../../../../../@babel_runtime@7.27.6/node_modules/@babel/runtime/helpers/extends.js";
 import { __require as J } from "../../../../../is-function@1.0.2/node_modules/is-function/index.js";

package/dist/shop-minis-react/node_modules/.pnpm/mpd-parser@1.3.1/node_modules/mpd-parser/dist/mpd-parser.es.js

@@ -2,7 +2,7 @@ import L from "../../../../@videojs_vhs-utils@4.1.1/node_modules/@videojs/vhs-ut
 import T from "../../../../../../../_virtual/window.js";
 import { forEachMediaGroup as Z } from "../../../../@videojs_vhs-utils@4.1.1/node_modules/@videojs/vhs-utils/es/media-groups.js";
 import J from "../../../../@videojs_vhs-utils@4.1.1/node_modules/@videojs/vhs-utils/es/decode-b64-to-uint8-array.js";
-import { l as Q } from "../../../../../../../_virtual/index5.js";
+import { l as Q } from "../../../../../../../_virtual/index6.js";
 /*! @name mpd-parser @version 1.3.1 @license Apache-2.0 */
 const w = (e) => !!e && typeof e == "object", E = (...e) => e.reduce((n, t) => (typeof t != "object" || Object.keys(t).forEach((r) => {
   Array.isArray(n[r]) && Array.isArray(t[r]) ? n[r] = n[r].concat(t[r]) : w(n[r]) && w(t[r]) ? n[r] = E(n[r], t[r]) : n[r] = t[r];

package/dist/shop-minis-react/node_modules/.pnpm/querystringify@2.2.0/node_modules/querystringify/index.js

@@ -1,4 +1,4 @@
-import { __exports as i } from "../../../../../../_virtual/index6.js";
+import { __exports as i } from "../../../../../../_virtual/index4.js";
 var c;
 function d() {
   if (c) return i;

package/dist/utils/buildDeeplinkUrl.js

@@ -0,0 +1,10 @@
+function r(i) {
+  const { handle: n } = window.minisParams;
+  if (!n)
+    throw new Error("Mini handle is not set");
+  return `https://shop.app/mini/${n}${i}`;
+}
+export {
+  r as buildDeeplinkUrl
+};
+//# sourceMappingURL=buildDeeplinkUrl.js.map

package/dist/utils/buildDeeplinkUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildDeeplinkUrl.js","sources":["../../src/utils/buildDeeplinkUrl.ts"],"sourcesContent":["/**\n * Builds a deeplink URL for a Shop Mini.\n *\n * @param path - The path within the mini (should start with '/').\n * @returns The full deeplink URL. Structure: https://shop.app/mini/{handle}{path}\n *\n * @example\n * buildDeeplinkUrl('/products/123')\n * // Returns: 'https://shop.app/mini/my-mini/products/123'\n */\nexport function buildDeeplinkUrl(path: string): string {\n  const {handle} = window.minisParams\n\n  if (!handle) {\n    throw new Error('Mini handle is not set')\n  }\n\n  return `https://shop.app/mini/${handle}${path}`\n}\n"],"names":["buildDeeplinkUrl","path","handle"],"mappings":"AAUO,SAASA,EAAiBC,GAAsB;AAC/C,QAAA,EAAC,QAAAC,MAAU,OAAO;AAExB,MAAI,CAACA;AACG,UAAA,IAAI,MAAM,wBAAwB;AAGnC,SAAA,yBAAyBA,CAAM,GAAGD,CAAI;AAC/C;"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shopify/shop-minis-react",
   "license": "SEE LICENSE IN LICENSE.txt",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "sideEffects": false,
   "type": "module",
   "engines": {

package/src/utils/buildDeeplinkUrl.ts

@@ -0,0 +1,19 @@
+/**
+ * Builds a deeplink URL for a Shop Mini.
+ *
+ * @param path - The path within the mini (should start with '/').
+ * @returns The full deeplink URL. Structure: https://shop.app/mini/{handle}{path}
+ *
+ * @example
+ * buildDeeplinkUrl('/products/123')
+ * // Returns: 'https://shop.app/mini/my-mini/products/123'
+ */
+export function buildDeeplinkUrl(path: string): string {
+  const {handle} = window.minisParams
+
+  if (!handle) {
+    throw new Error('Mini handle is not set')
+  }
+
+  return `https://shop.app/mini/${handle}${path}`
+}

package/src/utils/index.ts

@@ -1,3 +1,4 @@
+export * from './buildDeeplinkUrl'
 export * from './errors'
 export * from './merchant-card'
 export * from './parseUrl'