medusa-storefront-core 1.2.2 → 1.2.3

package/dist/edge.d.ts

@@ -0,0 +1,2 @@
+export { medusaListRegions, medusaMergeCarts } from 'medusa-services';
+export type { MedusaMiddlewareClientOptions } from 'medusa-services';

package/dist/error-boundary.d.ts

@@ -0,0 +1,15 @@
+import { default as React, Component, ReactNode } from 'react';
+
+type Props = {
+    children: ReactNode;
+    fallback?: ReactNode | ((error: Error) => ReactNode);
+};
+type State = {
+    error: Error | null;
+};
+export declare class StorefrontErrorBoundary extends Component<Props, State> {
+    state: State;
+    static getDerivedStateFromError(error: Error): State;
+    render(): string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<React.AwaitedReactNode> | import("react/jsx-runtime").JSX.Element | null | undefined;
+}
+export {};

package/dist/errors.d.ts

@@ -0,0 +1,2 @@
+export declare function parseMedusaStoreError(response: Response): Promise<string>;
+export declare function getErrorMessage(error: unknown, fallback?: string): string;

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types';
+export * from './errors';
+export * from './provider';
+export * from './use-storefront-action';
+export * from './site-config';
+export { StorefrontErrorBoundary } from './error-boundary';

package/dist/provider.d.ts

@@ -0,0 +1,21 @@
+import { default as React } from 'react';
+import { StorefrontCompanyConfig } from './site-config';
+
+export type MedusaSiteContextValue = {
+    countryCode?: string;
+    regionId?: string;
+    publishableKey?: string;
+    backendUrl?: string;
+    company?: StorefrontCompanyConfig;
+};
+export type MedusaSiteProviderProps = {
+    children: React.ReactNode;
+    value?: MedusaSiteContextValue;
+    countryCode?: string;
+    regionId?: string;
+    company?: StorefrontCompanyConfig;
+};
+export declare function MedusaSiteProvider({ children, value, countryCode, regionId, company, }: MedusaSiteProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useMedusaSite(): MedusaSiteContextValue;
+/** Shorthand for company details from site config. */
+export declare function useSiteCompany(): StorefrontCompanyConfig;

package/dist/site-config.d.ts

@@ -0,0 +1,63 @@
+import { Metadata } from 'next';
+
+/** Footer / share social icon link */
+export type StorefrontSocialLink = {
+    name: string;
+    url: string;
+    icon?: string;
+};
+/** Company / brand details passed from each storefront — never hardcode in libraries. */
+export type StorefrontCompanyConfig = {
+    name: string;
+    brandName?: string;
+    customerLabel?: string;
+    contactEmail?: string;
+    phone?: string;
+    description?: string;
+    helpTagline?: string;
+    mapTitle?: string;
+    whyChooseUsTitle?: string;
+    termsSubtitle?: string;
+    privacySubtitle?: string;
+    /**
+     * Fallback footer social links when Medusa admin has no `social-links` config.
+     * Overrides library defaults; set in each storefront's `site.config.ts`.
+     */
+    defaultSocialLinks?: StorefrontSocialLink[];
+};
+/** Site-specific values passed from each storefront project. */
+export type StorefrontSiteConfig = {
+    siteName: string;
+    siteUrl: string;
+    company?: StorefrontCompanyConfig;
+    gtmId?: string;
+    locale?: string;
+    htmlLang?: string;
+    icons?: {
+        icon?: string;
+        apple?: string;
+    };
+    seo: {
+        titleTemplate: string;
+        defaultTitle: string;
+        description: string;
+        openGraph?: {
+            title?: string;
+            description?: string;
+            image?: string;
+            imageAlt?: string;
+            locale?: string;
+        };
+        twitter?: {
+            title?: string;
+            description?: string;
+            image?: string;
+        };
+    };
+    features?: {
+        cookieConsent?: boolean;
+        metaPixelGuard?: boolean;
+        gtm?: boolean;
+    };
+};
+export declare function buildSiteMetadata(config: StorefrontSiteConfig, metadataBase: URL): Metadata;

package/dist/types.d.ts

@@ -0,0 +1,12 @@
+export type StorefrontErrorCode = "UNKNOWN" | "NETWORK" | "UNAUTHORIZED" | "NOT_FOUND" | "VALIDATION" | "CONFIG";
+export type StorefrontResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    code: StorefrontErrorCode;
+    message: string;
+};
+export declare function ok<T>(data: T): StorefrontResult<T>;
+export declare function err<T = never>(message: string, code?: StorefrontErrorCode): StorefrontResult<T>;
+export declare function fromCaught(error: unknown, fallback?: string): StorefrontResult<never>;

package/dist/ui-library.js

@@ -0,0 +1,144 @@
+var g = Object.defineProperty;
+var h = (e, t, r) => t in e ? g(e, t, { enumerable: !0, configurable: !0, writable: !0, value: r }) : e[t] = r;
+var l = (e, t, r) => h(e, typeof t != "symbol" ? t + "" : t, r);
+import { parseStoreErrorMessage as y } from "medusa-services";
+import { jsx as f } from "react/jsx-runtime";
+import { useMemo as U, useContext as S, createContext as C, useTransition as _, useState as p, useCallback as b, Component as N } from "react";
+function L(e) {
+  return { ok: !0, data: e };
+}
+function k(e, t = "UNKNOWN") {
+  return { ok: !1, code: t, message: e };
+}
+function M(e, t = "Something went wrong") {
+  const r = e instanceof Error ? e.message : t;
+  return k(r);
+}
+async function P(e) {
+  return y(e);
+}
+function B(e, t = "Something went wrong") {
+  return e instanceof Error ? e.message : typeof e == "string" ? e : t;
+}
+const m = {
+  name: "Store",
+  brandName: "Store",
+  customerLabel: "Customer"
+}, d = C({
+  company: m
+});
+function K({
+  children: e,
+  value: t,
+  countryCode: r,
+  regionId: s,
+  company: i
+}) {
+  const a = U(
+    () => ({
+      countryCode: (t == null ? void 0 : t.countryCode) ?? r,
+      regionId: (t == null ? void 0 : t.regionId) ?? s,
+      publishableKey: (t == null ? void 0 : t.publishableKey) ?? process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY,
+      backendUrl: (t == null ? void 0 : t.backendUrl) ?? process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL ?? process.env.MEDUSA_BACKEND_URL,
+      company: (t == null ? void 0 : t.company) ?? i ?? m
+    }),
+    [t, r, s, i]
+  );
+  return /* @__PURE__ */ f(d.Provider, { value: a, children: e });
+}
+function I() {
+  return S(d);
+}
+function j() {
+  return S(d).company ?? m;
+}
+function F(e) {
+  const [t, r] = _(), [s, i] = p(null), [a, u] = p(null);
+  return { run: b(
+    (...E) => (i(null), new Promise((c) => {
+      r(() => {
+        (async () => {
+          try {
+            const o = await e(...E);
+            if (o && typeof o == "object" && "ok" in o) {
+              const n = o;
+              n.ok === !0 ? u(n.data) : n.ok === !1 && i(n.message), c(n);
+            } else
+              u(o), c({ ok: !0, data: o });
+          } catch (o) {
+            const n = M(o);
+            n.ok === !1 && i(n.message), c(n);
+          }
+        })();
+      });
+    })),
+    [e]
+  ), isPending: t, error: s, data: a, clearError: () => i(null) };
+}
+function G(e, t) {
+  const r = e.seo.openGraph ?? {}, s = e.seo.twitter ?? {};
+  return {
+    metadataBase: t,
+    title: {
+      template: e.seo.titleTemplate,
+      default: e.seo.defaultTitle
+    },
+    description: e.seo.description,
+    openGraph: {
+      title: r.title ?? e.seo.defaultTitle,
+      description: r.description ?? e.seo.description,
+      url: e.siteUrl,
+      siteName: e.siteName,
+      images: r.image ? [
+        {
+          url: r.image,
+          width: 1200,
+          height: 630,
+          alt: r.imageAlt ?? e.siteName
+        }
+      ] : void 0,
+      locale: r.locale ?? e.locale ?? "en_US",
+      type: "website"
+    },
+    twitter: {
+      card: "summary_large_image",
+      title: s.title ?? e.seo.defaultTitle,
+      description: s.description ?? e.seo.description,
+      images: s.image ? [s.image] : r.image ? [r.image] : void 0
+    },
+    icons: e.icons,
+    alternates: {
+      canonical: e.siteUrl
+    }
+  };
+}
+class O extends N {
+  constructor() {
+    super(...arguments);
+    l(this, "state", { error: null });
+  }
+  static getDerivedStateFromError(r) {
+    return { error: r };
+  }
+  render() {
+    const { error: r } = this.state;
+    if (r) {
+      const { fallback: s } = this.props;
+      return typeof s == "function" ? s(r) : s || /* @__PURE__ */ f("div", { role: "alert", className: "p-4 text-sm text-red-700", children: r.message });
+    }
+    return this.props.children;
+  }
+}
+export {
+  K as MedusaSiteProvider,
+  O as StorefrontErrorBoundary,
+  G as buildSiteMetadata,
+  k as err,
+  M as fromCaught,
+  B as getErrorMessage,
+  L as ok,
+  P as parseMedusaStoreError,
+  I as useMedusaSite,
+  j as useSiteCompany,
+  F as useStorefrontAction
+};

package/dist/ui-library.umd.cjs

@@ -0,0 +1 @@
+(function(r,o){typeof exports=="object"&&typeof module<"u"?o(exports,require("medusa-services"),require("react/jsx-runtime"),require("react")):typeof define=="function"&&define.amd?define(["exports","medusa-services","react/jsx-runtime","react"],o):(r=typeof globalThis<"u"?globalThis:r||self,o(r.MedusaStorefrontCore={},r.MedusaServices,r.jsxRuntime,r.React))})(this,function(r,o,d,i){"use strict";var A=Object.defineProperty;var P=(r,o,d)=>o in r?A(r,o,{enumerable:!0,configurable:!0,writable:!0,value:d}):r[o]=d;var g=(r,o,d)=>P(r,typeof o!="symbol"?o+"":o,d);function h(e){return{ok:!0,data:e}}function S(e,t="UNKNOWN"){return{ok:!1,code:t,message:e}}function y(e,t="Something went wrong"){const s=e instanceof Error?e.message:t;return S(s)}async function M(e){return o.parseStoreErrorMessage(e)}function C(e,t="Something went wrong"){return e instanceof Error?e.message:typeof e=="string"?e:t}const m={name:"Store",brandName:"Store",customerLabel:"Customer"},l=i.createContext({company:m});function U({children:e,value:t,countryCode:s,regionId:n,company:c}){const f=i.useMemo(()=>({countryCode:(t==null?void 0:t.countryCode)??s,regionId:(t==null?void 0:t.regionId)??n,publishableKey:(t==null?void 0:t.publishableKey)??process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY,backendUrl:(t==null?void 0:t.backendUrl)??process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL??process.env.MEDUSA_BACKEND_URL,company:(t==null?void 0:t.company)??c??m}),[t,s,n,c]);return d.jsx(l.Provider,{value:f,children:e})}function b(){return i.useContext(l)}function _(){return i.useContext(l).company??m}function k(e){const[t,s]=i.useTransition(),[n,c]=i.useState(null),[f,E]=i.useState(null);return{run:i.useCallback((...w)=>(c(null),new Promise(p=>{s(()=>{(async()=>{try{const u=await e(...w);if(u&&typeof u=="object"&&"ok"in u){const a=u;a.ok===!0?E(a.data):a.ok===!1&&c(a.message),p(a)}else E(u),p({ok:!0,data:u})}catch(u){const a=y(u);a.ok===!1&&c(a.message),p(a)}})()})})),[e]),isPending:t,error:n,data:f,clearError:()=>c(null)}}function N(e,t){const s=e.seo.openGraph??{},n=e.seo.twitter??{};return{metadataBase:t,title:{template:e.seo.titleTemplate,default:e.seo.defaultTitle},description:e.seo.description,openGraph:{title:s.title??e.seo.defaultTitle,description:s.description??e.seo.description,url:e.siteUrl,siteName:e.siteName,images:s.image?[{url:s.image,width:1200,height:630,alt:s.imageAlt??e.siteName}]:void 0,locale:s.locale??e.locale??"en_US",type:"website"},twitter:{card:"summary_large_image",title:n.title??e.seo.defaultTitle,description:n.description??e.seo.description,images:n.image?[n.image]:s.image?[s.image]:void 0},icons:e.icons,alternates:{canonical:e.siteUrl}}}class T extends i.Component{constructor(){super(...arguments);g(this,"state",{error:null})}static getDerivedStateFromError(s){return{error:s}}render(){const{error:s}=this.state;if(s){const{fallback:n}=this.props;return typeof n=="function"?n(s):n||d.jsx("div",{role:"alert",className:"p-4 text-sm text-red-700",children:s.message})}return this.props.children}}r.MedusaSiteProvider=U,r.StorefrontErrorBoundary=T,r.buildSiteMetadata=N,r.err=S,r.fromCaught=y,r.getErrorMessage=C,r.ok=h,r.parseMedusaStoreError=M,r.useMedusaSite=b,r.useSiteCompany=_,r.useStorefrontAction=k,Object.defineProperty(r,Symbol.toStringTag,{value:"Module"})});

package/dist/use-storefront-action.d.ts

@@ -0,0 +1,9 @@
+import { StorefrontResult } from './types';
+
+export declare function useStorefrontAction<TArgs extends unknown[], TData>(action: (...args: TArgs) => Promise<StorefrontResult<TData> | TData>): {
+    run: (...args: TArgs) => Promise<StorefrontResult<TData>>;
+    isPending: boolean;
+    error: string | null;
+    data: TData | null;
+    clearError: () => void;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "medusa-storefront-core",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "Core types, providers, and error handling for Medusa storefronts.",
   "type": "module",
   "license": "MIT",