medusa-services 1.1.0

package/dist/recently-viewed.js

@@ -0,0 +1,59 @@
+const DEFAULT_RECENTLY_VIEWED_STORAGE_KEY = "medusa_pdp_recently_viewed";
+const DEFAULT_MAX_ITEMS = 20;
+function getStorageKey(options) {
+    return options?.storageKey || DEFAULT_RECENTLY_VIEWED_STORAGE_KEY;
+}
+function getMaxItems(options) {
+    const max = options?.maxItems ?? DEFAULT_MAX_ITEMS;
+    return max > 0 ? max : DEFAULT_MAX_ITEMS;
+}
+function canUseStorage() {
+    return typeof window !== "undefined" && !!window.localStorage;
+}
+function sanitizeIds(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((id) => typeof id === "string" && id.trim() !== "");
+}
+function readRecentlyViewedIds(options) {
+    if (!canUseStorage())
+        return [];
+    try {
+        const raw = window.localStorage.getItem(getStorageKey(options));
+        if (!raw)
+            return [];
+        const parsed = JSON.parse(raw);
+        return sanitizeIds(parsed);
+    }
+    catch {
+        return [];
+    }
+}
+function writeRecentlyViewedIds(ids, options) {
+    if (!canUseStorage())
+        return;
+    try {
+        window.localStorage.setItem(getStorageKey(options), JSON.stringify(ids));
+    }
+    catch {
+        // Ignore storage errors (quota/private mode)
+    }
+}
+/**
+ * Local-first recently viewed service.
+ * Later, swap internals with API calls without changing callers.
+ */
+export const recentlyViewedService = {
+    getAll(options) {
+        return readRecentlyViewedIds(options);
+    },
+    track(productId, options) {
+        const current = readRecentlyViewedIds(options);
+        const next = [productId, ...current.filter((id) => id !== productId)].slice(0, getMaxItems(options));
+        writeRecentlyViewedIds(next, options);
+        return next;
+    },
+    clear(options) {
+        writeRecentlyViewedIds([], options);
+    },
+};

package/dist/regions.d.ts

@@ -0,0 +1,37 @@
+import { type MedusaStoreClientOptions } from "./store-api";
+export interface StoreRegionCountry {
+    iso_2?: string | null;
+    [key: string]: unknown;
+}
+export interface StoreRegion {
+    id: string;
+    name?: string;
+    currency_code?: string;
+    countries?: StoreRegionCountry[];
+    [key: string]: unknown;
+}
+export interface StoreRegionListResponse {
+    regions: StoreRegion[];
+}
+export interface StoreRegionResponse {
+    region: StoreRegion;
+}
+/**
+ * GET /store/regions
+ */
+export declare function medusaRegionList(options: MedusaStoreClientOptions, query?: {
+    fields?: string;
+}): Promise<StoreRegionListResponse>;
+/**
+ * GET /store/regions/:id
+ */
+export declare function medusaRegionRetrieve(regionId: string, options: MedusaStoreClientOptions, query?: {
+    fields?: string;
+}): Promise<StoreRegionResponse>;
+/**
+ * Resolve a region by ISO-2 country code from the store regions list.
+ */
+export declare function medusaRegionByCountryCode(countryCode: string, options: MedusaStoreClientOptions, query?: {
+    fields?: string;
+}): Promise<StoreRegion | null>;
+//# sourceMappingURL=regions.d.ts.map

package/dist/regions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regions.d.ts","sourceRoot":"","sources":["../regions.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,KAAK,wBAAwB,EAChC,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,kBAAkB;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACpC,OAAO,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,WAAW,CAAC;CACvB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAClC,OAAO,EAAE,wBAAwB,EACjC,KAAK,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAOlC;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,wBAAwB,EACjC,KAAK,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAO9B;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC3C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,wBAAwB,EACjC,KAAK,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAe7B"}

package/dist/regions.js

@@ -0,0 +1,30 @@
+import { fieldsQuery, parseStoreJson, storeFetch, } from "./store-api";
+/**
+ * GET /store/regions
+ */
+export async function medusaRegionList(options, query) {
+    const response = await storeFetch(`/regions${fieldsQuery(query?.fields)}`, options, { method: "GET" });
+    return parseStoreJson(response, "Region list request");
+}
+/**
+ * GET /store/regions/:id
+ */
+export async function medusaRegionRetrieve(regionId, options, query) {
+    const response = await storeFetch(`/regions/${encodeURIComponent(regionId)}${fieldsQuery(query?.fields)}`, options, { method: "GET" });
+    return parseStoreJson(response, "Region retrieve request");
+}
+/**
+ * Resolve a region by ISO-2 country code from the store regions list.
+ */
+export async function medusaRegionByCountryCode(countryCode, options, query) {
+    const { regions } = await medusaRegionList(options, query);
+    if (!regions?.length)
+        return null;
+    const normalized = countryCode?.toLowerCase();
+    for (const region of regions) {
+        const match = region.countries?.find((country) => country.iso_2?.toLowerCase() === normalized);
+        if (match)
+            return region;
+    }
+    return regions.find((region) => region.countries?.some((country) => country.iso_2?.toLowerCase() === "us")) ?? regions[0] ?? null;
+}

package/dist/related-products.d.ts

@@ -0,0 +1,30 @@
+export interface RelatedProductsMedusaOptions {
+    backendUrl: string;
+    publishableApiKey: string;
+    regionId?: string;
+    limit?: number;
+    headers?: Record<string, string>;
+}
+export interface RelatedProductCard {
+    id: string;
+    title: string;
+    handle?: string;
+    thumbnail?: string;
+    averageRating?: number;
+    totalRatingCount?: number;
+}
+export interface FetchRelatedProductsInput {
+    currentProductId: string;
+    collectionId?: string;
+    tagIds?: string[];
+    options: RelatedProductsMedusaOptions;
+}
+/**
+ * Deterministic fallback:
+ * 1) same collection + shared tags
+ * 2) same collection only
+ * 3) shared tags only
+ * 4) generic latest list
+ */
+export declare function medusaFetchRelatedProducts({ currentProductId, collectionId, tagIds, options, }: FetchRelatedProductsInput): Promise<RelatedProductCard[]>;
+//# sourceMappingURL=related-products.d.ts.map

package/dist/related-products.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"related-products.d.ts","sourceRoot":"","sources":["../related-products.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,4BAA4B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACtC,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,4BAA4B,CAAC;CACzC;AA2DD;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAAC,EAC7C,gBAAgB,EAChB,YAAY,EACZ,MAAW,EACX,OAAO,GACV,EAAE,yBAAyB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAgD3D"}

package/dist/related-products.js

@@ -0,0 +1,99 @@
+function getOrigin(baseUrl) {
+    return baseUrl.replace(/\/$/, '');
+}
+function toArray(value) {
+    if (Array.isArray(value))
+        return value;
+    if (value == null)
+        return [];
+    return [value];
+}
+function getPublicHeaders(options) {
+    return {
+        'x-publishable-api-key': options.publishableApiKey,
+        ...options.headers,
+    };
+}
+function mapToRelatedCard(product) {
+    const id = typeof product.id === 'string' ? product.id : '';
+    const title = typeof product.title === 'string' ? product.title : '';
+    if (!id || !title)
+        return null;
+    return {
+        id,
+        title,
+        handle: typeof product.handle === 'string' ? product.handle : undefined,
+        thumbnail: typeof product.thumbnail === 'string' ? product.thumbnail : undefined,
+        averageRating: typeof product.average_rating === 'number' ? product.average_rating : undefined,
+        totalRatingCount: typeof product.total_rating_count === 'number' ? product.total_rating_count : undefined,
+    };
+}
+async function fetchProducts(query, options) {
+    const url = `${getOrigin(options.backendUrl)}/store/products?${query.toString()}`;
+    const response = await fetch(url, {
+        method: 'GET',
+        headers: getPublicHeaders(options),
+    });
+    if (!response.ok) {
+        const data = await response.json().catch(() => ({}));
+        const message = typeof data.message === 'string'
+            ? data.message
+            : `Failed related products request (${response.status})`;
+        throw new Error(message);
+    }
+    const data = (await response.json());
+    return Array.isArray(data.products) ? data.products : [];
+}
+/**
+ * Deterministic fallback:
+ * 1) same collection + shared tags
+ * 2) same collection only
+ * 3) shared tags only
+ * 4) generic latest list
+ */
+export async function medusaFetchRelatedProducts({ currentProductId, collectionId, tagIds = [], options, }) {
+    const target = options.limit && options.limit > 0 ? options.limit : 8;
+    const tagIdList = tagIds.filter((id) => typeof id === 'string' && id.trim() !== '');
+    const collected = new Map();
+    const scenarios = [
+        { withCollection: true, withTags: true },
+        { withCollection: true, withTags: false },
+        { withCollection: false, withTags: true },
+        { withCollection: false, withTags: false },
+    ];
+    for (const scenario of scenarios) {
+        if (collected.size >= target)
+            break;
+        const query = new URLSearchParams();
+        query.set('limit', String(Math.max(target * 2, 12)));
+        query.set('is_giftcard', 'false');
+        if (options.regionId)
+            query.set('region_id', options.regionId);
+        if (scenario.withCollection && collectionId) {
+            query.set('collection_id', collectionId);
+        }
+        if (scenario.withTags && tagIdList.length > 0) {
+            for (const tagId of tagIdList) {
+                query.append('tag_id', tagId);
+            }
+        }
+        const missingFilters = (scenario.withCollection && !collectionId) ||
+            (scenario.withTags && tagIdList.length === 0);
+        if (missingFilters)
+            continue;
+        const products = await fetchProducts(query, options);
+        for (const raw of products) {
+            const card = mapToRelatedCard(raw);
+            if (!card)
+                continue;
+            if (card.id === currentProductId)
+                continue;
+            if (!collected.has(card.id)) {
+                collected.set(card.id, card);
+            }
+            if (collected.size >= target)
+                break;
+        }
+    }
+    return Array.from(collected.values()).slice(0, target);
+}

package/dist/returns.d.ts

@@ -0,0 +1,75 @@
+import { type MedusaStoreClientOptions } from "./store-api";
+export interface StoreReturnReason {
+    id: string;
+    label?: string;
+    value?: string;
+    description?: string;
+    [key: string]: unknown;
+}
+export interface StoreReturnReasonListResponse {
+    return_reasons: StoreReturnReason[];
+}
+export interface StoreReturn {
+    id?: string;
+    [key: string]: unknown;
+}
+export interface StoreReturnResponse {
+    return: StoreReturn;
+}
+export interface StoreReturnListResponse {
+    returns?: StoreReturn[];
+    count?: number;
+    [key: string]: unknown;
+}
+export interface CreateReturnPayload {
+    order_id: string;
+    items: Array<{
+        id: string;
+        quantity: number;
+        reason_id?: string;
+        note?: string;
+    }>;
+    return_shipping?: {
+        option_id: string;
+        location_id: string;
+    };
+    note?: string;
+}
+/**
+ * GET /store/return-reasons
+ */
+export declare function medusaReturnReasonList(options: MedusaStoreClientOptions): Promise<StoreReturnReason[]>;
+/**
+ * GET /store/shipping-options?cart_id=&is_return=true
+ */
+export declare function medusaReturnShippingOptionsList(cartId: string, options: MedusaStoreClientOptions): Promise<import("./fulfillment").StoreShippingOption[]>;
+/**
+ * List return shipping options; creates ephemeral cart when regionId provided and cartId empty.
+ */
+export declare function medusaReturnShippingOptionsResolve(options: MedusaStoreClientOptions, params: {
+    cartId?: string;
+    regionId?: string;
+}): Promise<import("./fulfillment").StoreShippingOption[]>;
+/**
+ * POST /store/returns
+ */
+export declare function medusaReturnCreate(payload: CreateReturnPayload, options: MedusaStoreClientOptions): Promise<StoreReturn>;
+/**
+ * POST /store/guest-orders/:id/returns
+ */
+export declare function medusaReturnCreateGuest(orderId: string, payload: CreateReturnPayload | Record<string, unknown>, options: MedusaStoreClientOptions): Promise<StoreReturn>;
+/**
+ * PUT /store/refund-payment-mapping/:returnId
+ */
+export declare function medusaReturnUpdatePayment(returnId: string, paymentId: string, options: MedusaStoreClientOptions): Promise<unknown>;
+/**
+ * GET /store/returns
+ */
+export declare function medusaReturnList(options: MedusaStoreClientOptions, query?: {
+    order_id?: string;
+}): Promise<StoreReturnListResponse>;
+/**
+ * GET /store/guest-orders/:id/returns
+ */
+export declare function medusaReturnListGuest(orderId: string, options: MedusaStoreClientOptions): Promise<StoreReturnListResponse>;
+//# sourceMappingURL=returns.d.ts.map

package/dist/returns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"returns.d.ts","sourceRoot":"","sources":["../returns.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAIxF,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,6BAA6B;IAC1C,cAAc,EAAE,iBAAiB,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACpC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QACT,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,eAAe,CAAC,EAAE;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CACxC,OAAO,EAAE,wBAAwB,GAClC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAW9B;AAED;;GAEG;AACH,wBAAsB,+BAA+B,CACjD,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,wBAAwB,GAClC,OAAO,CAAC,OAAO,eAAe,EAAE,mBAAmB,EAAE,CAAC,CAKxD;AAED;;GAEG;AACH,wBAAsB,kCAAkC,CACpD,OAAO,EAAE,wBAAwB,EACjC,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,OAAO,CAAC,OAAO,eAAe,EAAE,mBAAmB,EAAE,CAAC,CAwBxD;AAUD;;GAEG;AACH,wBAAsB,kBAAkB,CACpC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,wBAAwB,GAClC,OAAO,CAAC,WAAW,CAAC,CAUtB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CACzC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtD,OAAO,EAAE,wBAAwB,GAClC,OAAO,CAAC,WAAW,CAAC,CAWtB;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC3C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,wBAAwB,GAClC,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAClC,OAAO,EAAE,wBAAwB,EACjC,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,OAAO,CAAC,uBAAuB,CAAC,CAQlC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,wBAAwB,GAClC,OAAO,CAAC,uBAAuB,CAAC,CAOlC"}

package/dist/returns.js

@@ -0,0 +1,105 @@
+import { parseStoreJson, storeFetch } from "./store-api";
+import { medusaCartCreate } from "./cart";
+import { medusaShippingOptionsList } from "./fulfillment";
+/**
+ * GET /store/return-reasons
+ */
+export async function medusaReturnReasonList(options) {
+    try {
+        const response = await storeFetch("/return-reasons", options, { method: "GET" });
+        const data = await parseStoreJson(response, "Return reason list request");
+        return data.return_reasons ?? [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * GET /store/shipping-options?cart_id=&is_return=true
+ */
+export async function medusaReturnShippingOptionsList(cartId, options) {
+    const { shipping_options } = await medusaShippingOptionsList(cartId, options, {
+        is_return: true,
+    });
+    return shipping_options;
+}
+/**
+ * List return shipping options; creates ephemeral cart when regionId provided and cartId empty.
+ */
+export async function medusaReturnShippingOptionsResolve(options, params) {
+    if (params.cartId) {
+        try {
+            const options_ = await medusaReturnShippingOptionsList(params.cartId, options);
+            if (options_.length > 0) {
+                return options_;
+            }
+        }
+        catch {
+            // fallback below
+        }
+    }
+    if (params.regionId) {
+        try {
+            const { cart } = await medusaCartCreate(options, { region_id: params.regionId });
+            if (cart?.id) {
+                return medusaReturnShippingOptionsList(cart.id, options);
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    return [];
+}
+function unwrapReturnResponse(data) {
+    const wrapped = data;
+    if (wrapped.return && typeof wrapped.return === "object") {
+        return wrapped.return;
+    }
+    return data;
+}
+/**
+ * POST /store/returns
+ */
+export async function medusaReturnCreate(payload, options) {
+    const response = await storeFetch("/returns", options, {
+        method: "POST",
+        body: JSON.stringify(payload),
+    });
+    const data = await parseStoreJson(response, "Return create request");
+    return unwrapReturnResponse(data);
+}
+/**
+ * POST /store/guest-orders/:id/returns
+ */
+export async function medusaReturnCreateGuest(orderId, payload, options) {
+    const response = await storeFetch(`/guest-orders/${encodeURIComponent(orderId)}/returns`, options, { method: "POST", body: JSON.stringify(payload) });
+    const data = await parseStoreJson(response, "Guest return create request");
+    return unwrapReturnResponse(data);
+}
+/**
+ * PUT /store/refund-payment-mapping/:returnId
+ */
+export async function medusaReturnUpdatePayment(returnId, paymentId, options) {
+    const response = await storeFetch(`/refund-payment-mapping/${encodeURIComponent(returnId)}`, options, { method: "PUT", body: JSON.stringify({ payment_id: paymentId }) });
+    return parseStoreJson(response, "Return payment update request");
+}
+/**
+ * GET /store/returns
+ */
+export async function medusaReturnList(options, query) {
+    const params = new URLSearchParams();
+    if (query?.order_id) {
+        params.set("order_id", query.order_id);
+    }
+    const path = params.toString() ? `/returns?${params.toString()}` : "/returns";
+    const response = await storeFetch(path, options, { method: "GET" });
+    return parseStoreJson(response, "Return list request");
+}
+/**
+ * GET /store/guest-orders/:id/returns
+ */
+export async function medusaReturnListGuest(orderId, options) {
+    const response = await storeFetch(`/guest-orders/${encodeURIComponent(orderId)}/returns`, options, { method: "GET" });
+    return parseStoreJson(response, "Guest return list request");
+}

package/dist/reviews.d.ts

@@ -0,0 +1,135 @@
+/**
+ * medusa-review-rating Store API helpers.
+ * @see package README (store routes under /store)
+ */
+export interface MedusaReviewsClientOptions {
+    backendUrl: string;
+    publishableApiKey: string;
+    headers?: Record<string, string>;
+}
+/**
+ * Medusa store URL + publishable key from common Next.js / Node env vars.
+ */
+export declare function getMedusaReviewsClientOptionsFromEnv(): MedusaReviewsClientOptions;
+/** Customer JWT or full `Bearer …` — required for write + “my reviews” routes */
+export interface MedusaReviewsAuthenticatedOptions extends MedusaReviewsClientOptions {
+    authorization: string;
+}
+export interface MedusaProductRatingApiBody {
+    rating?: {
+        average_rating?: number;
+        total_reviews?: number;
+        total_rating_sum?: number;
+    };
+}
+export interface ProductRatingSummary {
+    averageRating: number;
+    totalReviews: number;
+}
+export interface MedusaStoreRatingEntry {
+    product_id?: string;
+    average_rating?: number;
+    total_reviews?: number;
+    total_rating_sum?: number;
+}
+/**
+ * GET /store/ratings — all product ratings, or filter by product_id.
+ */
+export declare function medusaListRatings(options: MedusaReviewsClientOptions, query?: {
+    product_id?: string;
+}): Promise<{
+    rating: MedusaStoreRatingEntry[];
+}>;
+/**
+ * GET /store/products/:id/rating
+ */
+export declare function medusaGetProductRatingSummary(productId: string, options: MedusaReviewsClientOptions): Promise<ProductRatingSummary>;
+export interface MedusaProductReview {
+    id: string;
+    product_id: string;
+    customer_id?: string;
+    rating: number;
+    title?: string | null;
+    description?: string | null;
+    images?: string[] | null;
+    verified_purchase?: boolean;
+    status?: string;
+    created_at?: string;
+    updated_at?: string;
+}
+export interface MedusaListProductReviewsQuery {
+    status?: 'approved' | 'pending' | 'rejected';
+    limit?: number;
+    offset?: number;
+}
+/**
+ * GET /store/products/:id/reviews
+ */
+export declare function medusaListProductReviews(productId: string, options: MedusaReviewsClientOptions, query?: MedusaListProductReviewsQuery): Promise<{
+    reviews: MedusaProductReview[];
+}>;
+export interface MedusaSubmitReviewBody {
+    product_id: string;
+    rating: number;
+    title?: string;
+    description?: string;
+    images?: string[];
+}
+/**
+ * POST /store/reviews
+ */
+export declare function medusaSubmitReview(body: MedusaSubmitReviewBody, options: MedusaReviewsAuthenticatedOptions): Promise<{
+    review: MedusaProductReview;
+}>;
+export interface MedusaUpdateReviewBody {
+    rating?: number;
+    title?: string;
+    description?: string;
+    images?: string[];
+}
+/**
+ * PUT /store/reviews/:id
+ */
+export declare function medusaUpdateReview(reviewId: string, body: MedusaUpdateReviewBody, options: MedusaReviewsAuthenticatedOptions): Promise<{
+    review: MedusaProductReview;
+}>;
+/**
+ * GET /store/reviews/:id
+ */
+export declare function medusaGetStoreReview(reviewId: string, options: MedusaReviewsClientOptions): Promise<{
+    review: MedusaProductReview;
+}>;
+export interface MedusaCustomerReviewsSummary {
+    total_reviews?: number;
+    average_rating?: number;
+    total_rating_sum?: number;
+    product_id?: string;
+}
+/**
+ * GET /store/reviews/me
+ */
+export declare function medusaListCustomerReviews(options: MedusaReviewsAuthenticatedOptions, query?: {
+    product_id?: string;
+    status?: 'approved' | 'pending' | 'rejected';
+}): Promise<{
+    reviews: MedusaProductReview[];
+    summary?: MedusaCustomerReviewsSummary;
+}>;
+/**
+ * GET /store/products/:id/reviews/me
+ */
+export declare function medusaListCustomerProductReviews(productId: string, options: MedusaReviewsAuthenticatedOptions): Promise<{
+    reviews: MedusaProductReview[];
+    summary?: MedusaCustomerReviewsSummary;
+}>;
+export interface MedusaUploadedFile {
+    url: string;
+}
+/**
+ * POST /store/upload — multipart FormData with `files` field(s).
+ * Do not set Content-Type; the runtime sets the boundary.
+ */
+export declare function medusaUploadStoreFiles(formData: FormData, options: MedusaReviewsAuthenticatedOptions): Promise<{
+    files: MedusaUploadedFile[];
+}>;
+//# sourceMappingURL=reviews.d.ts.map

package/dist/reviews.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviews.d.ts","sourceRoot":"","sources":["../reviews.ts"],"names":[],"mappings":"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"}