@ecomiq/storefront 2.1.4 → 3.0.1

package/dist/account-Dx4e3syi.js

@@ -0,0 +1,258 @@
+import { optional, text } from "./form-BtQcbXlJ.js";
+import { identityDocumentError, isIdentityDocumentType } from "./documents-T1mzc_j8.js";
+import { ADDRESS_INTENTS, ORDER_REQUEST_INTENTS, isIntent } from "./form-contracts-BNpHaTGJ.js";
+import { readPlace } from "./place-CmW4hBWY.js";
+import { customerHeaders, requireCustomer, requireCustomerWith } from "./session-CKvmFJyg.js";
+import { found, readCountries, readDocumentCountries, store } from "./store-8Q-_LFrQ.js";
+import { requestUrl } from "./urls-CpGQPxvf.js";
+import { data } from "react-router";
+import { ApiError } from "@ecomiq/core";
+// src/account.ts
+const DEFAULT_ADDRESS_LABEL = "Casa";
+function placeName(form, name) {
+	const value = text(form, name);
+	if (value.includes("|")) return readPlace(value).name;
+	return value;
+}
+function readCustomerAddress(form, countryCode) {
+	return {
+		addressKey: text(form, "label") || DEFAULT_ADDRESS_LABEL,
+		countryIsoCode: countryCode,
+		addressLine: text(form, "line"),
+		department: placeName(form, "department") || null,
+		province: placeName(form, "province") || null,
+		district: placeName(form, "district") || null,
+		cellPhone: optional(form, "phone"),
+		reference: optional(form, "reference"),
+		isDefault: form.get("default") === "on"
+	};
+}
+async function loadAccount(request, context) {
+	return { name: (await requireCustomer(request, context)).name };
+}
+const ORDER_STATUSES = [
+	"open",
+	"delivered",
+	"cancelled"
+];
+function readOrderFilters(url) {
+	const status = ORDER_STATUSES.find((value) => value === url.searchParams.get("status")) ?? null;
+	const sort = url.searchParams.get("sort") === "oldest" ? "oldest" : "newest";
+	const view = url.searchParams.get("view") === "grid" ? "grid" : "list";
+	return {
+		q: (url.searchParams.get("q") ?? "").trim().slice(0, 100),
+		status,
+		sort,
+		view
+	};
+}
+/** The query string of the orders list for these filters, without the default values. */
+function orderFiltersQuery(filters) {
+	const query = new URLSearchParams();
+	if (filters.q !== "") query.set("q", filters.q);
+	if (filters.status !== null) query.set("status", filters.status);
+	if (filters.sort === "oldest") query.set("sort", "oldest");
+	if (filters.view === "grid") query.set("view", "grid");
+	return query;
+}
+async function loadOrders(request, context) {
+	const url = requestUrl(request);
+	const filters = readOrderFilters(url);
+	const page = await requireCustomerWith(request, context, (headers) => store(context).getCustomerOrders({
+		...headers,
+		cursor: url.searchParams.get("cursor") ?? void 0,
+		search: filters.q || void 0,
+		status: filters.status ?? void 0,
+		sortDirection: filters.sort === "oldest" ? "asc" : "desc"
+	}));
+	let next = null;
+	if (page.hasNextPage && page.nextCursor) {
+		const query = orderFiltersQuery(filters);
+		query.set("cursor", page.nextCursor);
+		next = `${url.pathname}?${query}`;
+	}
+	return {
+		orders: page.data,
+		next,
+		filters
+	};
+}
+async function loadOrder(request, context, id) {
+	return { order: await found(requireCustomerWith(request, context, (headers) => store(context).getCustomerOrder(id, headers))) };
+}
+const MAX_RETURN_PHOTOS = 3;
+function orderRequestError(error, intent) {
+	const code = error instanceof ApiError ? error.code ?? "" : "";
+	if (code.includes("Receipt")) return "Las fotos deben ser JPG, PNG o WebP de hasta 5 MB.";
+	if (code === "Orders.ReturnPhotosLimit") return "Puedes adjuntar hasta 3 fotos.";
+	if (code === "Orders.ReturnQuantityInvalid") return "Revisa las cantidades a devolver.";
+	if (code === "Orders.ReturnUnavailable") return "Este pedido ya no admite devoluciones.";
+	if (code === "Orders.CancellationUnavailable") return "Este pedido ya no se puede cancelar.";
+	return intent === "return" ? "No pudimos enviar tu solicitud de devolución." : "No pudimos enviar tu solicitud de cancelación.";
+}
+function returnLines(form) {
+	const quantities = form.getAll("quantity");
+	return form.getAll("itemId").map((itemId, index) => ({
+		itemId: String(itemId),
+		quantity: Number(quantities[index] ?? 0)
+	})).filter((line) => line.itemId !== "" && Number.isInteger(line.quantity) && line.quantity > 0);
+}
+/** Return or cancellation request the customer sends from an order of their account. */
+async function orderRequestAction(request, context, orderId) {
+	const current = await requireCustomer(request, context);
+	const client = store(context);
+	const headers = customerHeaders(current);
+	const form = await request.formData();
+	const intent = text(form, "intent");
+	if (!isIntent(ORDER_REQUEST_INTENTS, intent)) return data({
+		sent: null,
+		error: "Acción no válida."
+	}, { status: 400 });
+	const reason = text(form, "reason");
+	const comment = text(form, "comment") || void 0;
+	if (reason === "") return data({
+		sent: null,
+		error: "Elige un motivo."
+	}, { status: 400 });
+	try {
+		if (intent === "cancel") {
+			await client.requestCustomerOrderCancellation(orderId, {
+				reason,
+				comment
+			}, headers);
+			return {
+				sent: "cancel",
+				error: null
+			};
+		}
+		const items = returnLines(form);
+		if (items.length === 0) return data({
+			sent: null,
+			error: "Elige qué productos quieres devolver."
+		}, { status: 400 });
+		const photos = form.getAll("photos").filter((photo) => photo instanceof File && photo.size > 0);
+		if (photos.length > MAX_RETURN_PHOTOS) return data({
+			sent: null,
+			error: "Puedes adjuntar hasta 3 fotos."
+		}, { status: 400 });
+		await client.requestCustomerOrderReturn(orderId, {
+			reason,
+			comment,
+			items,
+			photos
+		}, headers);
+		return {
+			sent: "return",
+			error: null
+		};
+	} catch (error) {
+		return data({
+			sent: null,
+			error: orderRequestError(error, intent)
+		}, { status: 400 });
+	}
+}
+async function loadAddresses(request, context) {
+	const client = store(context);
+	const [addresses, countries] = await requireCustomerWith(request, context, (headers) => Promise.all([client.getCustomerAddresses(headers), readCountries(client)]));
+	return {
+		addresses,
+		countries
+	};
+}
+async function addressAction(request, context) {
+	const current = await requireCustomer(request, context);
+	const client = store(context);
+	const headers = customerHeaders(current);
+	const form = await request.formData();
+	const intent = text(form, "intent") || "save";
+	if (!isIntent(ADDRESS_INTENTS, intent)) return data({ error: "Acción no válida." }, { status: 400 });
+	try {
+		if (intent === "delete") {
+			await client.deleteCustomerAddress(text(form, "id"), headers);
+			return { error: null };
+		}
+		if (intent === "default") {
+			const address = (await client.getCustomerAddresses(headers)).find((item) => item.id === text(form, "id"));
+			if (address) await client.updateCustomerAddress(address.id, {
+				...address,
+				isDefault: true
+			}, headers);
+			return { error: null };
+		}
+		const { store: settings } = await client.getSettings();
+		const requestedCountry = text(form, "country");
+		if (requestedCountry !== "" && requestedCountry !== settings.countryCode) return data({ error: "La dirección debe ser dentro del país de la tienda." }, { status: 400 });
+		const input = readCustomerAddress(form, settings.countryCode);
+		if (!input.addressLine || !input.district || !input.cellPhone) return data({ error: "Completa la dirección, el distrito y el celular." }, { status: 400 });
+		const id = text(form, "id");
+		if (id) await client.updateCustomerAddress(id, input, headers);
+		else await client.createCustomerAddress(input, headers);
+		return { error: null };
+	} catch (error) {
+		if (error instanceof ApiError && error.status < 500) return data({ error: "Revisa los datos de la dirección." }, { status: 400 });
+		return data({ error: "No pudimos guardar la dirección." }, { status: 400 });
+	}
+}
+async function loadProfile(request, context) {
+	const client = store(context);
+	const [me, countries] = await requireCustomerWith(request, context, (headers) => Promise.all([client.getCustomerMe(headers), readDocumentCountries(client)]));
+	return {
+		me,
+		countries
+	};
+}
+async function profileAction(request, context) {
+	const current = await requireCustomer(request, context);
+	const client = store(context);
+	const headers = customerHeaders(current);
+	const form = await request.formData();
+	const firstName = text(form, "firstName");
+	const lastName = text(form, "lastName");
+	try {
+		const me = await client.getCustomerMe(headers);
+		const { store: settings } = await client.getSettings();
+		const number = text(form, "document");
+		const type = text(form, "identificationType");
+		const country = text(form, "identificationCountryCode");
+		if (number !== "" && !isIdentityDocumentType(type)) return data({
+			saved: false,
+			error: "Elige el tipo de documento."
+		}, { status: 400 });
+		const documentError = isIdentityDocumentType(type) ? identityDocumentError(type, country, number) : null;
+		if (documentError) return data({
+			saved: false,
+			error: documentError
+		}, { status: 400 });
+		if (me.entityIdentificationNumber && !/^[A-Z]{2}$/.test(country)) return data({
+			saved: false,
+			error: "Elige el país emisor del documento."
+		}, { status: 400 });
+		await client.patchCustomer({
+			firstName,
+			lastName,
+			phone: text(form, "phone"),
+			identificationNumber: number || null,
+			identificationType: number ? type : null,
+			identificationCountryCode: number || me.entityIdentificationNumber ? country : null,
+			entityName: me.entityName,
+			entityIdentificationNumber: me.entityIdentificationNumber,
+			gender: me.gender || null,
+			role: me.role,
+			companyName: me.companyName,
+			dateOfBirth: me.dateOfBirth,
+			consent: me.consent,
+			countryIsoCode: me.countryIsoCode ?? settings.countryCode
+		}, headers);
+		return {
+			saved: true,
+			error: null
+		};
+	} catch {
+		return data({
+			saved: false,
+			error: "No pudimos guardar tus datos."
+		}, { status: 400 });
+	}
+}
+export { addressAction, loadAccount, loadAddresses, loadOrder, loadOrders, loadProfile, orderFiltersQuery, orderRequestAction, profileAction, readCustomerAddress, readOrderFilters };

package/dist/account-forms-AVk71ko7.js

@@ -0,0 +1,39 @@
+import { CustomerCsrfField } from "./customer-csrf-C1oDX-Py.js";
+import { usePageAction } from "./page-action-Ctkf4xC6.js";
+import { Form } from "react-router";
+import { jsx, jsxs } from "react/jsx-runtime";
+// src/account-forms.tsx
+const ADDRESS_ACTION = "/account/addresses";
+const PROFILE_ACTION = "/account/profile";
+function AddressForm({ intent = "save", addressId, children, ...props }) {
+	const action = usePageAction(ADDRESS_ACTION);
+	return /* @__PURE__ */ jsxs(Form, {
+		method: "post",
+		action,
+		...props,
+		children: [
+			/* @__PURE__ */ jsx(CustomerCsrfField, {}),
+			/* @__PURE__ */ jsx("input", {
+				type: "hidden",
+				name: "intent",
+				value: intent
+			}),
+			/* @__PURE__ */ jsx("input", {
+				type: "hidden",
+				name: "id",
+				value: addressId ?? ""
+			}),
+			children
+		]
+	});
+}
+function ProfileForm({ children, ...props }) {
+	const action = usePageAction(PROFILE_ACTION);
+	return /* @__PURE__ */ jsxs(Form, {
+		method: "post",
+		action,
+		...props,
+		children: [/* @__PURE__ */ jsx(CustomerCsrfField, {}), children]
+	});
+}
+export { ADDRESS_ACTION, AddressForm, PROFILE_ACTION, ProfileForm };

package/dist/account-forms.d.ts

@@ -0,0 +1,13 @@
+import { FetcherFormProps } from "react-router";
+type FormProps = Omit<FetcherFormProps, "action" | "method" | "encType">;
+export type AddressFormProps = FormProps & ({
+  intent?: "save";
+  addressId?: string | null;
+} | {
+  intent: "default" | "delete";
+  addressId: string;
+});
+export type ProfileFormProps = FormProps;
+export declare function AddressForm({ intent, addressId, children, ...props }: AddressFormProps): import("react").JSX.Element;
+export declare function ProfileForm({ children, ...props }: ProfileFormProps): import("react").JSX.Element;
+export {};

package/dist/account.d.ts

@@ -0,0 +1,240 @@
+import { OrderRequestIntent } from "./form-contracts.js";
+import { RouterContextProvider } from "react-router";
+import { CustomerAddressUpsertInput, CustomerOrderList, CustomerOrderStatusFilter } from "@ecomiq/core";
+export type AddressActionData = {
+  error: string | null;
+};
+export type ProfileActionData = {
+  saved: boolean;
+  error: string | null;
+};
+export type OrderRequestActionData = {
+  sent: OrderRequestIntent | null;
+  error: string | null;
+};
+export declare function readCustomerAddress(form: FormData, countryCode: string): CustomerAddressUpsertInput;
+export declare function loadAccount(request: Request, context: Readonly<RouterContextProvider>): Promise<{
+  name: string;
+}>;
+export type OrderFilters = {
+  q: string;
+  status: CustomerOrderStatusFilter | null;
+  sort: "newest" | "oldest";
+  view: "list" | "grid";
+};
+export type OrdersData = {
+  orders: CustomerOrderList;
+  next: string | null;
+  filters: OrderFilters;
+};
+export declare function readOrderFilters(url: URL): OrderFilters;
+/** The query string of the orders list for these filters, without the default values. */
+export declare function orderFiltersQuery(filters: OrderFilters): URLSearchParams;
+export declare function loadOrders(request: Request, context: Readonly<RouterContextProvider>): Promise<OrdersData>;
+export declare function loadOrder(request: Request, context: Readonly<RouterContextProvider>, id: string): Promise<{
+  order: {
+    id: string;
+    orderNumber: string;
+    orderGroup: string | null;
+    status: string;
+    step?: "cancelled" | "confirmed" | "delivered" | "outForDelivery" | "pending" | "shipped" | undefined;
+    total: number;
+    totalPaid: number;
+    currencyCode: string;
+    orderDate: string;
+    createdOn: string;
+    updatedOn: string | null;
+    paymentAt: string | null;
+    subTotal: number;
+    discount: number;
+    shipping: number;
+    tax: number;
+    email: string | null;
+    phone: string | null;
+    identificationType?: string | null | undefined;
+    identificationNumber?: string | null | undefined;
+    identificationCountryCode?: string | null | undefined;
+    firstName: string | null;
+    lastName: string | null;
+    shippingAddress: {
+      name: string | null;
+      company: string | null;
+      address1: string;
+      address2: string | null;
+      city: string;
+      countryCode: string;
+      province: string | null;
+      postalCode: string | null;
+      district: string | null;
+      phone: string | null;
+      latitude: number | null;
+      longitude: number | null;
+      metadata: Record<string, unknown>;
+    };
+    shippingAddressSummary: string | null;
+    billingAddress: {
+      name: string | null;
+      company: string | null;
+      address1: string;
+      address2: string | null;
+      city: string;
+      countryCode: string;
+      province: string | null;
+      postalCode: string | null;
+      district: string | null;
+      phone: string | null;
+      latitude: number | null;
+      longitude: number | null;
+      metadata: Record<string, unknown>;
+    };
+    items: {
+      id: string;
+      orderId: string;
+      productId: string | null;
+      variantId: string | null;
+      title: string;
+      subtitle: string | null;
+      thumbnail: string | null;
+      variantTitle: string | null;
+      productHandle: string | null;
+      productUrl: string | null;
+      quantity: number;
+      unitPrice: number;
+      total: number;
+      status: string;
+      step?: "cancelled" | "confirmed" | "delivered" | "outForDelivery" | "pending" | "shipped" | undefined;
+      carrierName?: string | null | undefined;
+      trackingNumber?: string | null | undefined;
+      trackingLink?: string | null | undefined;
+      shippedAt?: string | null | undefined;
+      deliveredAt?: string | null | undefined;
+      returnableQuantity: number;
+    }[];
+    payments: {
+      id: string;
+      paymentMethod: string;
+      paymentCode: string;
+      cardBrand?: string | null | undefined;
+      cardLast4?: string | null | undefined;
+      installments?: number | null | undefined;
+      amount: number;
+      paymentStatus: string | null;
+      receiptUrl: string | null;
+      createdOn: string;
+    }[];
+    statusTimeline: {
+      key: string;
+      label: string;
+      occurredAt: string;
+      description: string | null;
+      status: string | null;
+      source: string;
+    }[];
+    shipments: {
+      carrierName: string | null;
+      trackingNumber: string | null;
+      trackingLink: string | null;
+    }[];
+    paymentPath?: string | null | undefined;
+    returnStatus?: string | null | undefined;
+    returnDeadline?: string | null | undefined;
+    canRequestReturn: boolean;
+    cancellationRequestedAt?: string | null | undefined;
+    canRequestCancellation: boolean;
+  };
+}>;
+/** Return or cancellation request the customer sends from an order of their account. */
+export declare function orderRequestAction(request: Request, context: Readonly<RouterContextProvider>, orderId: string): Promise<import("react-router").UNSAFE_DataWithResponseInit<OrderRequestActionData> | {
+  sent: "cancel";
+  error: null;
+} | {
+  sent: "return";
+  error: null;
+}>;
+export declare function loadAddresses(request: Request, context: Readonly<RouterContextProvider>): Promise<{
+  addresses: {
+    id: string;
+    addressKey: string;
+    department: string | null;
+    addressNumber: string | null;
+    province: string | null;
+    district: string | null;
+    phone: string | null;
+    cellPhone: string | null;
+    addressLine: string;
+    reference: string | null;
+    countryIsoCode: string;
+    postalCode: string | null;
+    latitude: number | null;
+    longitude: number | null;
+    hasCoordinates: boolean;
+    isDefault: boolean;
+  }[];
+  countries: {
+    code: string;
+    name: string;
+  }[];
+}>;
+export declare function addressAction(request: Request, context: Readonly<RouterContextProvider>): Promise<import("react-router").UNSAFE_DataWithResponseInit<AddressActionData> | {
+  error: null;
+}>;
+export declare function loadProfile(request: Request, context: Readonly<RouterContextProvider>): Promise<{
+  me: {
+    id: string;
+    storeId: string;
+    email: string | null;
+    firstName: string | null;
+    lastName: string | null;
+    phone: string | null;
+    identificationNumber: string | null;
+    identificationType: string | null;
+    identificationCountryCode?: string | null | undefined;
+    entityName: string | null;
+    dateOfBirth: string | null;
+    gender: string;
+    countryIsoCode: string | null;
+    role: string | null;
+    companyName: string | null;
+    consent: boolean;
+    userId: string | null;
+    customerType: string;
+    status: string;
+    isVerified: boolean;
+    entityIdentificationNumber: string | null;
+    defaultAddressId: string | null;
+    metadata: Record<string, unknown> | null;
+    totalOrders: number;
+    avgOrders: number;
+    lastOrderId: string | null;
+    lastOrderDate: string | null;
+    loyaltyPoints: number;
+    addresses: {
+      id: string;
+      addressKey: string;
+      department: string | null;
+      addressNumber: string | null;
+      province: string | null;
+      district: string | null;
+      phone: string | null;
+      cellPhone: string | null;
+      addressLine: string;
+      reference: string | null;
+      countryIsoCode: string;
+      postalCode: string | null;
+      latitude: number | null;
+      longitude: number | null;
+      hasCoordinates: boolean;
+      isDefault: boolean;
+    }[];
+    createdOn: string;
+    updatedOn: string | null;
+  };
+  countries: {
+    code: string;
+    name: string;
+  }[];
+}>;
+export declare function profileAction(request: Request, context: Readonly<RouterContextProvider>): Promise<import("react-router").UNSAFE_DataWithResponseInit<ProfileActionData> | {
+  saved: true;
+  error: null;
+}>;

package/dist/address-defaults-BqjRhS82.js

@@ -0,0 +1,14 @@
+// src/address-defaults.ts
+function addressDefaults(address) {
+	if (!address) return {};
+	return {
+		country: address.countryIsoCode,
+		department: address.department,
+		province: address.province,
+		district: address.district,
+		line: address.addressLine,
+		reference: address.reference,
+		phone: address.cellPhone ?? address.phone
+	};
+}
+export { addressDefaults };

package/dist/address-defaults.d.ts

@@ -0,0 +1,11 @@
+import { CustomerAddress } from "@ecomiq/core";
+export type AddressDefaults = {
+  country?: string | null;
+  department?: string | null;
+  province?: string | null;
+  district?: string | null;
+  line?: string | null;
+  reference?: string | null;
+  phone?: string | null;
+};
+export declare function addressDefaults(address: CustomerAddress | null | undefined): AddressDefaults;