orionplace-react 0.1.0 → 0.2.0

package/templates/lib/orionplace/productSearch.ts

@@ -0,0 +1,232 @@
+import type {
+  IProductSearchFacets,
+  ProductFacetSelection,
+} from '@/interfaces/orionplace/products/IProductSearchFacets';
+import type {
+  IProductSearchFilters,
+  IProductSearchResponse,
+} from '@/interfaces/orionplace/products/IProductSearchApi';
+import type { OrionplaceApi } from '@/lib/orionplace/api';
+
+export type ProductSearchPage = NonNullable<
+  IProductSearchResponse['page_data']
+>;
+
+export interface ProductSearchScope {
+  query?: string;
+  categoryId?: number;
+  // The category and its public descendants (`catalogBranchIds`).
+  categoryIds?: number[];
+  sellerId?: number;
+  manufacturerId?: number;
+  storeId?: number;
+  featured?: boolean;
+}
+
+export interface ProductSearchScopeNames {
+  manufacturer?: string;
+  seller?: string;
+  store?: string;
+}
+
+export interface ProductSearchScopeLabels {
+  home: string;
+  searchCrumb: string;
+  searchResults: string;
+  products: string;
+  manufacturers: string;
+  sellers: string;
+  stores: string;
+  manufacturerProducts: string;
+  sellerProducts: string;
+  storeProducts: string;
+}
+
+export interface ProductSearchCrumb {
+  label: string;
+  path?: string;
+  query?: Record<string, string | number>;
+}
+
+interface DirectoryScope {
+  queryKey: 'manufacturer' | 'seller' | 'store';
+  id: number;
+  name: string;
+  section: string;
+  sectionPath: string;
+  caption: string;
+}
+
+function directoryScopes(
+  scope: ProductSearchScope,
+  names: ProductSearchScopeNames,
+  labels: ProductSearchScopeLabels,
+): DirectoryScope[] {
+  const entries: Array<DirectoryScope | undefined> = [
+    scope.manufacturerId
+      ? {
+          queryKey: 'manufacturer',
+          id: scope.manufacturerId,
+          name: names.manufacturer ?? '',
+          section: labels.manufacturers,
+          sectionPath: '/manufacturers',
+          caption: labels.manufacturerProducts,
+        }
+      : undefined,
+    scope.sellerId
+      ? {
+          queryKey: 'seller',
+          id: scope.sellerId,
+          name: names.seller ?? '',
+          section: labels.sellers,
+          sectionPath: '/sellers',
+          caption: labels.sellerProducts,
+        }
+      : undefined,
+    scope.storeId
+      ? {
+          queryKey: 'store',
+          id: scope.storeId,
+          name: names.store ?? '',
+          section: labels.stores,
+          sectionPath: '/stores',
+          caption: labels.storeProducts,
+        }
+      : undefined,
+  ];
+
+  return entries.filter((entry): entry is DirectoryScope => Boolean(entry));
+}
+
+export function productSearchTrail(
+  scope: ProductSearchScope,
+  names: ProductSearchScopeNames,
+  labels: ProductSearchScopeLabels,
+): ProductSearchCrumb[] {
+  const query                              = scope.query?.trim() ?? '';
+  const directories                        = directoryScopes(scope, names, labels);
+  const trail: ProductSearchCrumb[]        = [{ label: labels.home, path: '/' }];
+  const scopeQuery: Record<string, number> = {};
+
+  if (directories[0]) {
+    trail.push({
+      label: directories[0].section,
+      path: directories[0].sectionPath,
+    });
+  } else {
+    trail.push({ label: labels.searchCrumb });
+  }
+
+  for (const directory of directories) {
+    scopeQuery[directory.queryKey] = directory.id;
+    trail.push({
+      label: directory.name || directory.caption,
+      path: '/browse',
+      query: { ...scopeQuery },
+    });
+  }
+
+  if (query) {
+    trail.push({ label: `«${query}»` });
+  }
+
+  const current                            = trail.at(-1);
+  if (current && trail.length > 1) {
+    delete current.path;
+    delete current.query;
+  }
+
+  return trail;
+}
+
+export function productSearchHeading(
+  scope: ProductSearchScope,
+  names: ProductSearchScopeNames,
+  labels: ProductSearchScopeLabels,
+) {
+  const [directory] = directoryScopes(scope, names, labels);
+
+  if (!directory) {
+    return { title: labels.searchResults, caption: '', named: false };
+  }
+
+  return {
+    title: directory.name || directory.caption,
+    caption: directory.caption,
+    named: Boolean(directory.name),
+  };
+}
+
+export function productSearchSeoTitle(
+  scope: ProductSearchScope,
+  names: ProductSearchScopeNames,
+  labels: ProductSearchScopeLabels,
+) {
+  const query   = scope.query?.trim() ?? '';
+  const heading = productSearchHeading(scope, names, labels);
+  const base    = heading.named
+    ? `${heading.title} — ${labels.products}`
+    : heading.title;
+
+  return query ? `${base} · ${query}` : base;
+}
+
+export function productSearchFixedFilters(
+  scope: ProductSearchScope,
+): IProductSearchFilters {
+  return {
+    ...(scope.query ? { search_string: scope.query } : {}),
+    ...(scope.categoryId
+      ? { categories: scope.categoryIds ?? [scope.categoryId] }
+      : {}),
+    ...(scope.sellerId ? { product_owner: [scope.sellerId] } : {}),
+    ...(scope.manufacturerId
+      ? { product_manufacture: [scope.manufacturerId] }
+      : {}),
+    ...(scope.storeId ? { physical_store: scope.storeId } : {}),
+    ...(scope.featured ? { only_featured: true } : {}),
+  };
+}
+
+export function productSearchFacetData(
+  page: ProductSearchPage | undefined,
+): IProductSearchFacets | null {
+  if (!page?.selects && !page?.variants) {
+    return null;
+  }
+  return {
+    selects: page.selects ?? {},
+    variants: page.variants,
+  } as IProductSearchFacets;
+}
+
+/** Products per result page, as in the Nuxt and Svelte packages. */
+export const productSearchPageSize = 12;
+
+export function productSearchRequest(
+  scope: ProductSearchScope,
+  filters: ProductFacetSelection,
+  page: number,
+) {
+  return {
+    filters: {
+      ...filters,
+      ...productSearchFixedFilters(scope),
+    } as IProductSearchFilters,
+    paginate: { page, pp_items: productSearchPageSize },
+  };
+}
+
+export async function loadProductSearch(
+  api: OrionplaceApi,
+  scope: ProductSearchScope,
+  filters: ProductFacetSelection = {},
+  page = 1,
+  signal?: AbortSignal,
+) {
+  return api.request<ProductSearchPage>(
+    'products_search',
+    productSearchRequest(scope, filters, page),
+    signal,
+  );
+}

package/templates/lib/orionplace/productSeller.ts

@@ -0,0 +1,56 @@
+import type {
+  IAppLoadProduct,
+  IProduct,
+  IProductSearchSeller,
+  IProductSeller,
+} from '@/interfaces/orionplace/products/IProduct';
+
+type LegacyAppLoadProduct = IAppLoadProduct & {
+  seller?: IProductSeller;
+};
+
+export function resolveAppLoadProducts(
+  products: readonly IAppLoadProduct[] | undefined,
+  sellers: Readonly<Record<string, IProductSeller>> | undefined,
+): IProduct[] {
+  const resolved: IProduct[] = [];
+
+  for (const product of products ?? []) {
+    const legacySeller = (product as LegacyAppLoadProduct).seller;
+    const seller = legacySeller ?? sellers?.[String(product.seller_id)];
+    if (!seller) {
+      continue;
+    }
+
+    resolved.push({ ...product, seller });
+  }
+
+  return resolved;
+}
+
+/**
+ * A product search response lists the preorder permission of each seller in
+ * `selects.sellers`. A product without its own `is_accepting_preorders`
+ * receives the permission of its seller; an existing value is kept.
+ */
+export function productWithSellerPermission(
+  product: IProduct,
+  sellers: readonly IProductSearchSeller[] = [],
+): IProduct {
+  if (product.seller.is_accepting_preorders != null) {
+    return product;
+  }
+
+  const seller = sellers.find((item) => item.id === product.seller.id);
+  if (typeof seller?.is_accepting_preorders !== 'boolean') {
+    return product;
+  }
+
+  return {
+    ...product,
+    seller: {
+      ...product.seller,
+      is_accepting_preorders: seller.is_accepting_preorders,
+    },
+  };
+}

package/templates/lib/orionplace/profile.ts

@@ -0,0 +1,157 @@
+import type { IStorefrontProfileState } from '@/interfaces/orionplace/accounts/IStorefrontProfile';
+import { fieldErrorText, type OrionplaceApiResponse } from '@/lib/orionplace/api';
+
+export function profileState(): IStorefrontProfileState {
+  return {
+    loaded: false,
+    pending: '',
+    error: '',
+    errors: {},
+    message: '',
+    saved: 0,
+    emailStep: 'step_email',
+    notificationLocale: '',
+    authStep: 'step_phone',
+    authPurpose: 'auth',
+    authCodeType: '',
+    authEmail: '',
+    otpDelay: 0,
+    refreshRequired: false,
+  };
+}
+
+/** Application Load uses day.month.year; date fields and requests use ISO dates. */
+export function profileDate(value: string | null | undefined) {
+  if (!value) {
+    return '';
+  }
+  if (/^\d{4}-\d{2}-\d{2}$/.test(value)) {
+    return value;
+  }
+  const parts = /^(\d{1,2})[./](\d{1,2})[./](\d{4})$/.exec(value);
+  return parts
+    ? `${parts[3]}-${parts[2]!.padStart(2, '0')}-${parts[1]!.padStart(2, '0')}`
+    : '';
+}
+
+export class ProfileRequestError extends Error {
+  readonly kind = 'profile-request';
+  readonly fields: Record<string, string>;
+
+  constructor(fields: Record<string, string>) {
+    super(fieldErrorText(fields));
+    this.name = 'ProfileRequestError';
+    this.fields = fields;
+  }
+}
+
+export function profileResponse(
+  response: OrionplaceApiResponse,
+  allowNextStep = false,
+) {
+  const body = response.body as {
+    form_errors?: Record<string, { message: string }[]> | null;
+    success_message?: string | null;
+    page_data?: Record<string, unknown> | null;
+  } | null;
+  const errors = Object.fromEntries(
+    Object.entries(body?.form_errors ?? {}).map(([key, values]) => [
+      key,
+      Array.isArray(values) ? values.map((item) => item.message).join(' ') : '',
+    ]),
+  );
+  if (
+    response.status < 200 ||
+    response.status >= 300 ||
+    body?.form_errors !== null ||
+    (!body.success_message &&
+      !(allowNextStep && typeof body.page_data?.next_step === 'string'))
+  ) {
+    throw new ProfileRequestError(errors);
+  }
+  return body.page_data ?? {};
+}
+
+export function applyProfileAuthenticationData(
+  state: IStorefrontProfileState,
+  data: Record<string, unknown>,
+) {
+  const next = { ...state };
+  const steps = ['step_phone', 'step_password', 'step_otp', 'step_additional'];
+  if (steps.includes(String(data.next_step))) {
+    next.authStep = data.next_step as IStorefrontProfileState['authStep'];
+  }
+  if (data.purpose === 'auth' || data.purpose === 'reg') {
+    next.authPurpose = data.purpose;
+  }
+  if (data.code_type !== undefined) {
+    next.authCodeType = ['sms', 'call', 'email'].includes(
+      String(data.code_type),
+    )
+      ? (data.code_type as IStorefrontProfileState['authCodeType'])
+      : '';
+    next.authEmail =
+      next.authCodeType === 'email' && typeof data.email === 'string'
+        ? data.email
+        : '';
+  }
+  if (data.otp_delay !== undefined) {
+    const seconds = Number(data.otp_delay);
+    next.otpDelay = Number.isFinite(seconds)
+      ? Math.max(0, Math.ceil(seconds))
+      : 0;
+  }
+  if (next.authStep !== 'step_otp') {
+    next.authCodeType = '';
+    next.authEmail = '';
+  }
+  return next;
+}
+
+/**
+ * Applies the step data of one profile response. A successful sign-in
+ * response can change the step or extend the resend countdown, including
+ * one that also returns form errors. Email verification returns to the
+ * address step after repeated invalid codes.
+ */
+export function profileResponseState(
+  state: IStorefrontProfileState,
+  name: string,
+  response: OrionplaceApiResponse,
+): IStorefrontProfileState {
+  const body          = response.body as {
+    page_data?: Record<string, unknown> | null;
+  } | null;
+  const pageData      = body?.page_data;
+  const transportedOk = response.status >= 200 && response.status < 300;
+
+  if (name === 'email_enroll' && pageData?.next_step === 'step_email') {
+    return { ...state, emailStep: 'step_email' };
+  }
+  if (name.startsWith('auth_') && pageData && transportedOk) {
+    return applyProfileAuthenticationData(state, pageData);
+  }
+
+  return state;
+}
+
+/**
+ * Returns to the phone step. The resend countdown keeps running, so the
+ * phone step still blocks another code request until it ends.
+ */
+export function restartProfileAuthentication(
+  state: IStorefrontProfileState,
+): IStorefrontProfileState {
+  return applyProfileAuthenticationData(
+    { ...state, error: '', errors: {}, message: '' },
+    { next_step: 'step_phone' },
+  );
+}
+
+/** Field errors keep their backend text; other failures use one message. */
+export function profileFailure(reason: unknown, failed: string) {
+  const fields = reason instanceof ProfileRequestError ? reason.fields : {};
+  const text   = reason instanceof ProfileRequestError ? reason.message : '';
+
+  return { errors: fields, error: text || failed };
+}

package/templates/lib/orionplace/profileLabels.ts

@@ -0,0 +1,151 @@
+export function profileLabels(locale: string) {
+  return locale.toLowerCase().startsWith('ru')
+    ? {
+        title: 'Личный профиль',
+        intro: 'Личные данные, уведомления и безопасность аккаунта.',
+        overview: 'Аккаунт',
+        home: 'Главная',
+        saved: 'Изменения сохранены.',
+        loading: 'Загружаем профиль…',
+        retry: 'Повторить',
+        failed: 'Не удалось выполнить запрос. Попробуйте ещё раз.',
+        details: 'Личные данные',
+        detailsHint: 'Имя, номер телефона для входа и дата рождения.',
+        firstName: 'Имя',
+        lastName: 'Фамилия',
+        phone: 'Номер телефона',
+        phoneHint: 'Номер телефона для входа.',
+        dob: 'Дата рождения',
+        save: 'Сохранить',
+        pending: 'Сохраняем…',
+        emailTitle: 'Почта и уведомления',
+        email: 'Электронная почта',
+        emailHint:
+          'Подтвердите адрес для получения уведомлений о заказах и рассылки.',
+        sendCode: 'Отправить',
+        sendCodeHint: 'Отправить код подтверждения',
+        code: 'Код подтверждения',
+        verify: 'Подтвердить',
+        changeEmail: 'Изменить',
+        changeEmailHint: 'Изменить адрес почты',
+        resend: 'Повторить',
+        resendHint: 'Повторить отправку кода',
+        notifications: 'Уведомления по почте',
+        notificationsHint: 'Письма о заказах, обращениях и подписках, о поступлении товаров и предложения. Коды для входа приходят всегда.',
+        notificationLocale: 'Язык писем',
+        chooseLocale: 'Выберите язык',
+        oldPassword: 'Текущий пароль',
+        newPassword: 'Новый пароль',
+        confirmPassword: 'Повторите новый пароль',
+        passwordHint: 'Не менее 6 символов.',
+        mismatch: 'Пароли не совпадают.',
+        changePassword: 'Изменить пароль',
+        createPassword: 'Создать пароль',
+        showPassword: 'Показать пароль',
+        hidePassword: 'Скрыть пароль',
+        avatar: 'Фотография профиля',
+        upload: 'Выбрать фото',
+        change: 'Изменить фото',
+        remove: 'Удалить фото',
+        signIn: 'Вход в аккаунт',
+        signInOrRegister: 'Вход и регистрация',
+        signUp: 'Регистрация',
+        signInHint:
+          'Введите номер телефона. Новый аккаунт можно создать после подтверждения номера.',
+        next: 'Продолжить',
+        password: 'Пароль',
+        back: 'Назад',
+        otpHint: 'Введите полученный код подтверждения.',
+        otpSms: 'Введите 4 цифры кода из СМС.',
+        otpCall: 'Введите последние 4 цифры номера входящего звонка.',
+        otpEmail: 'Введите код из письма, отправленного на',
+        signingIn: 'Выполняем вход…',
+        refreshFailed: 'Вход выполнен, но данные аккаунта не загрузились.',
+        cooldown: 'Новый код через',
+        phoneCooldown: 'Повторите через',
+        seconds: 'с',
+        deleteTitle: 'Удаление аккаунта',
+        deleteHint:
+          'Удаляет имя, номер телефона, почту, фото, адреса и корзину и выполняет выход. Заказы и отзывы остаются без ваших данных.',
+        deleteBlocked:
+          'Недоступно, пока есть открытый заказ, невыплаченный возврат, деньги на балансе или действующая платная подписка.',
+        deleteConfirm: 'Я понимаю, что аккаунт нельзя восстановить',
+        deleteAction: 'Удалить аккаунт',
+        deleting: 'Удаляем…',
+        deleted: 'Аккаунт удалён.',
+      }
+    : {
+        title: 'Personal profile',
+        intro: 'Your details, contact preferences and account security.',
+        overview: 'Account',
+        home: 'Home',
+        saved: 'Changes saved.',
+        loading: 'Loading your profile…',
+        retry: 'Retry',
+        failed: 'Could not complete the request. Please try again.',
+        details: 'Personal details',
+        detailsHint: 'Your name, sign-in phone number and date of birth.',
+        firstName: 'First name',
+        lastName: 'Last name',
+        phone: 'Phone number',
+        phoneHint: 'Your sign-in phone number.',
+        dob: 'Date of birth',
+        save: 'Save',
+        pending: 'Saving…',
+        emailTitle: 'Email & notifications',
+        email: 'Email address',
+        emailHint:
+          'Verify your address before receiving order updates and email notifications.',
+        sendCode: 'Send',
+        sendCodeHint: 'Send verification code',
+        code: 'Verification code',
+        verify: 'Verify',
+        changeEmail: 'Change',
+        changeEmailHint: 'Change email address',
+        resend: 'Resend',
+        resendHint: 'Send a new code',
+        notifications: 'Email notifications',
+        notificationsHint: 'Order, support and subscription updates, availability alerts and offers. Sign-in codes are always sent.',
+        notificationLocale: 'Email language',
+        chooseLocale: 'Choose a language',
+        oldPassword: 'Current password',
+        newPassword: 'New password',
+        confirmPassword: 'Confirm new password',
+        passwordHint: 'Use at least 6 characters.',
+        mismatch: 'The passwords do not match.',
+        changePassword: 'Update password',
+        createPassword: 'Create password',
+        showPassword: 'Show password',
+        hidePassword: 'Hide password',
+        avatar: 'Profile photo',
+        upload: 'Choose a photo',
+        change: 'Change photo',
+        remove: 'Remove photo',
+        signIn: 'Sign in to your account',
+        signInOrRegister: 'Sign in or register',
+        signUp: 'Create an account',
+        signInHint:
+          'Enter your phone number to continue. New customers can create an account here.',
+        next: 'Continue',
+        password: 'Password',
+        back: 'Back',
+        otpHint: 'Enter the verification code you received.',
+        otpSms: 'Enter the 4-digit code from the text message.',
+        otpCall: 'Enter the last 4 digits of the number calling you.',
+        otpEmail: 'Enter the code from the email sent to',
+        signingIn: 'Signing in…',
+        refreshFailed: 'Signed in, but account data could not be loaded.',
+        cooldown: 'Request another code in',
+        phoneCooldown: 'Try again in',
+        seconds: 's',
+        deleteTitle: 'Delete account',
+        deleteHint:
+          'Removes your name, phone number, email, photo, addresses and cart, and signs you out. Orders and reviews stay without your details.',
+        deleteBlocked:
+          'Not possible while an order is open, a refund is unpaid, money is on your balance or a paid subscription is active.',
+        deleteConfirm: 'I understand that the account cannot be restored',
+        deleteAction: 'Delete account',
+        deleting: 'Deleting…',
+        deleted: 'Your account has been deleted.',
+      };
+}

package/templates/lib/orionplace/promoLabels.ts

@@ -0,0 +1,75 @@
+const en = {
+  conditions: 'Conditions',
+  discount: 'Discount',
+  freeShipping: 'Free delivery',
+  scope: 'Applies to',
+  scopeSellers: 'Sellers',
+  scopeCategories: 'Categories',
+  scopeProducts: 'Products',
+  scopeEverything: 'Every product in the store',
+  minimumOrderAmount: 'Minimum order',
+  maximumDiscount: 'Maximum discount',
+  firstOrder: 'First purchase',
+  firstOrderOnly: 'Only for the first purchase in the store',
+  stacking: 'Discounted items',
+  stackingAllowed: 'The code also applies to them',
+  stackingBlocked: 'The code does not apply to them',
+  period: 'Valid',
+  until: 'Until',
+  untilLower: 'until',
+  since: 'From',
+  noPeriod: 'No end date',
+  usage: 'Uses left',
+  ofTotal: 'of',
+  unlimited: 'Unlimited',
+  separator: ', ',
+  crumbPromocodes: 'Promo codes',
+  crumbProducts: 'Products',
+  products: 'Products this code applies to',
+  productsHint:
+    'These products match the offer. A code still needs the conditions above.',
+  productsEmpty: 'No products match this offer right now.',
+  productsMissing: 'This offer is no longer running.',
+  openProducts: 'Show the products',
+  backToPromocodes: 'My promo codes',
+};
+
+const ru: typeof en = {
+  conditions: 'Условия',
+  discount: 'Скидка',
+  freeShipping: 'Бесплатная доставка',
+  scope: 'Действует на',
+  scopeSellers: 'Продавцы',
+  scopeCategories: 'Категории',
+  scopeProducts: 'Товары',
+  scopeEverything: 'Все товары магазина',
+  minimumOrderAmount: 'Минимальная сумма заказа',
+  maximumDiscount: 'Максимальная скидка',
+  firstOrder: 'Первая покупка',
+  firstOrderOnly: 'Только для первой покупки в магазине',
+  stacking: 'Товары со скидкой',
+  stackingAllowed: 'Промокод действует и на них',
+  stackingBlocked: 'Промокод на них не действует',
+  period: 'Срок действия',
+  until: 'До',
+  untilLower: 'до',
+  since: 'С',
+  noPeriod: 'Без даты окончания',
+  usage: 'Осталось применений',
+  ofTotal: 'из',
+  unlimited: 'Без ограничений',
+  separator: ', ',
+  crumbPromocodes: 'Промокоды',
+  crumbProducts: 'Товары',
+  products: 'Товары, на которые действует промокод',
+  productsHint:
+    'Эти товары подходят под акцию. Промокод применится, если выполнены условия выше.',
+  productsEmpty: 'Сейчас под эту акцию не подходит ни один товар.',
+  productsMissing: 'Эта акция больше не действует.',
+  openProducts: 'Показать товары',
+  backToPromocodes: 'Мои промокоды',
+};
+
+export function promoLabels(locale: string) {
+  return locale.toLowerCase().startsWith('ru') ? ru : en;
+}