orionplace-react 0.1.0 → 0.2.1

package/templates/lib/orionplace/blogLabels.ts

@@ -0,0 +1,108 @@
+const en = {
+  journal: 'Journal',
+  emptyJournal: 'No posts yet',
+  minutes: 'min read',
+  subscription: 'Subscription',
+  message: 'Comment',
+  send: 'Post',
+  replyTo: 'Reply to',
+  own: 'Your comment',
+  editing: 'Edit comment',
+  comments: 'Comments',
+  mine: 'Mine',
+  everyone: 'Discussion',
+  reply: 'Reply',
+  more: 'More',
+  moreReplies: 'Show more replies',
+  writeComment: 'Write a comment',
+  emptyComments: 'Be the first to leave a comment.',
+  noMine: 'You have no comments on this article yet.',
+  pending: 'Awaiting publication',
+  denied: 'Not published',
+  deleteQuestion: 'Delete this comment?',
+  fullAccess: 'Continue reading with a subscription',
+  fullAccessText:
+    'This is the beginning of the article. The full text opens with an active subscription plan that includes this article.',
+  tariffs: 'Plans',
+  tariffsHint: 'Subscription plans',
+  related: 'Products from this article',
+  unavailable: 'This article is unavailable.',
+  accessChanged: 'Article access has changed. Refresh to check access.',
+  back: 'Articles',
+  backHint: 'All articles',
+  video: 'Article video',
+  filters: 'Filters',
+  filtersHint: 'Show or hide article filters',
+  categories: 'Categories',
+  writers: 'Authors',
+  reset: 'Reset',
+  resetHint: 'Reset article filters',
+  articleCount: (count: number) =>
+    `${count} ${count === 1 ? 'article' : 'articles'}`,
+  noFiltered: 'No articles match the selected filters.',
+};
+
+function russianArticleCount(count: number) {
+  const remainder10 = count % 10;
+  const remainder100 = count % 100;
+  let noun = 'статей';
+
+  if (remainder10 === 1 && remainder100 !== 11) {
+    noun = 'статья';
+  } else if (
+    remainder10 >= 2 &&
+    remainder10 <= 4 &&
+    (remainder100 < 12 || remainder100 > 14)
+  ) {
+    noun = 'статьи';
+  }
+
+  return `${count} ${noun}`;
+}
+
+const ru: typeof en = {
+  journal: 'Журнал',
+  emptyJournal: 'Публикаций пока нет',
+  minutes: 'мин. чтения',
+  subscription: 'Подписка',
+  message: 'Комментарий',
+  send: 'Опубликовать',
+  replyTo: 'Ответ пользователю',
+  own: 'Ваш комментарий',
+  editing: 'Изменение комментария',
+  comments: 'Комментарии',
+  mine: 'Мои',
+  everyone: 'Обсуждение',
+  reply: 'Ответить',
+  more: 'Ещё',
+  moreReplies: 'Показать ещё ответы',
+  writeComment: 'Написать комментарий',
+  emptyComments: 'Оставьте первый комментарий к статье.',
+  noMine: 'Вы ещё не комментировали эту статью.',
+  pending: 'Ожидает публикации',
+  denied: 'Не опубликован',
+  deleteQuestion: 'Удалить этот комментарий?',
+  fullAccess: 'Продолжить чтение по подписке',
+  fullAccessText:
+    'Это начало статьи. Полный текст открывается при активной подписке на тариф, в который входит эта статья.',
+  tariffs: 'Тарифы',
+  tariffsHint: 'Тарифы подписки',
+  related: 'Товары из статьи',
+  unavailable: 'Статья недоступна.',
+  accessChanged: 'Доступ к статье изменился. Обновите страницу для проверки.',
+  back: 'Статьи',
+  backHint: 'Все статьи',
+  video: 'Видео к статье',
+  filters: 'Фильтры',
+  filtersHint: 'Показать или скрыть фильтры статей',
+  categories: 'Категории',
+  writers: 'Авторы',
+  reset: 'Сбросить',
+  resetHint: 'Сбросить фильтры статей',
+  articleCount: russianArticleCount,
+  noFiltered: 'Нет статей по выбранным фильтрам.',
+};
+
+export function blogLabels(locale: string) {
+  return locale.toLowerCase().startsWith('ru') ? ru : en;
+}

package/templates/lib/orionplace/blogPresentation.ts

@@ -0,0 +1,67 @@
+import { EBlogAccessType } from '@/interfaces/orionplace/blog/IBlogApi';
+import {
+  EBlogViewType,
+  type EBlogViewType as BlogViewType,
+  type IBlogPostPreview,
+} from '@/interfaces/orionplace/blog/IBlogPostPreview';
+import {
+  getAvailableNestedValueFromObject,
+  plainText,
+  safePublicUrl,
+} from '@/lib/orionplace/presentation';
+import { APP_ORIGIN, appMediaUrl } from '@/lib/orionplace/nativeApp';
+
+export function blogPostTitle(post: IBlogPostPreview, locale: string) {
+  return (
+    plainText(
+      getAvailableNestedValueFromObject(post.locale, locale, 'post_title'),
+    ) || String(post.id)
+  );
+}
+
+export function blogPostPreview(post: IBlogPostPreview, locale: string) {
+  return plainText(
+    getAvailableNestedValueFromObject(post.locale, locale, 'post_preview_text'),
+  );
+}
+
+export function blogPostCover(post: IBlogPostPreview) {
+  const images = [...(post.preview_images ?? [])].sort(
+    (left, right) => left.display_order - right.display_order,
+  );
+  return appMediaUrl(
+    safePublicUrl(images[0]?.image_url || post.preview_image_urls?.[0]),
+    APP_ORIGIN,
+  );
+}
+
+export function blogPostIsPaid(post: IBlogPostPreview) {
+  const access = post.access_type?.int;
+  return access !== undefined && access !== EBlogAccessType.ACCESS_PUBLIC;
+}
+
+export function blogCoverInitial(title: string) {
+  const letter = title.trim().match(/[\p{L}\p{N}]/u)?.[0] ?? '';
+  return letter.toLocaleUpperCase();
+}
+
+export function blogCoverPattern(postId: number) {
+  return Math.abs(postId) % 3;
+}
+
+export function blogViewType(value: unknown): BlogViewType {
+  const candidate =
+    typeof value === 'string' && value.trim() ? Number(value) : value;
+  if (candidate === EBlogViewType.LIST || candidate === EBlogViewType.CUSTOM) {
+    return candidate;
+  }
+  return EBlogViewType.PORTRAIT;
+}
+
+export function blogCustomGroups(posts: readonly IBlogPostPreview[]) {
+  const groups: IBlogPostPreview[][] = [];
+  for (let index = 1; index < posts.length; index += 3) {
+    groups.push(posts.slice(index, index + 3));
+  }
+  return groups;
+}

package/templates/lib/orionplace/browseLabels.ts

@@ -0,0 +1,98 @@
+export function browseLabels(locale: string) {
+  return locale.toLowerCase().startsWith('ru')
+    ? {
+        price: 'Цена',
+        from: 'От',
+        to: 'До',
+        priceFrom: 'Цена от',
+        priceTo: 'Цена до',
+        applyPrice: 'Применить',
+        moreFilters: 'Дополнительно',
+        discountFrom: 'Скидка от, %',
+        ratedProducts: 'Товары с оценкой от 4,5',
+        ratedSellers: 'Продавцы с оценкой от 4,5',
+        withReviews: 'Только с отзывами',
+        results: 'Найдено товаров',
+        products: 'Товары',
+        searchResults: 'Результаты поиска',
+        clear: 'Сбросить',
+        emptyTitle: 'Ничего не найдено',
+        emptyHint: 'Попробуйте изменить запрос или сбросить фильтры.',
+        emptyCategoryHint:
+          'В этой категории пока нет подходящих товаров. Попробуйте убрать фильтры или выбрать другую категорию.',
+        startTitle: 'Что вы ищете?',
+        startHint: 'Введите в поиске название товара — не менее трёх символов.',
+        page: 'Страница',
+        of: 'из',
+        categories: 'Категории',
+        sellers: 'Продавцы',
+        manufacturers: 'Производители',
+        stores: 'Магазины',
+        searchCrumb: 'Поиск',
+        breadcrumb: 'Путь к странице',
+        manufacturerProducts: 'Товары производителя',
+        sellerProducts: 'Товары продавца',
+        storeProducts: 'Товары в наличии в магазине',
+        filters: 'Фильтры',
+        emptyFilters: 'Нет доступных фильтров',
+        blog: 'Журнал',
+        emptyBlog: 'Публикаций пока нет',
+        minutes: 'мин. чтения',
+        loading: 'Загрузка…',
+        failed: 'Не удалось загрузить данные',
+        retry: 'Повторить',
+        previous: 'Назад',
+        next: 'Далее',
+        search: 'Найти',
+        query: 'Название товара (от 3 символов)',
+        home: 'Главная',
+      }
+    : {
+        price: 'Price',
+        from: 'From',
+        to: 'To',
+        priceFrom: 'Minimum price',
+        priceTo: 'Maximum price',
+        applyPrice: 'Apply',
+        moreFilters: 'More filters',
+        discountFrom: 'Minimum discount, %',
+        ratedProducts: 'Products rated 4.5 and above',
+        ratedSellers: 'Sellers rated 4.5 and above',
+        withReviews: 'With reviews only',
+        results: 'Products found',
+        products: 'Products',
+        searchResults: 'Search results',
+        clear: 'Clear',
+        emptyTitle: 'No products found',
+        emptyHint: 'Try another search or clear the filters.',
+        emptyCategoryHint:
+          'No matching products in this category yet. Try removing filters or choosing another category.',
+        startTitle: 'What are you looking for?',
+        startHint:
+          'Enter a product name in search — at least three characters.',
+        page: 'Page',
+        of: 'of',
+        categories: 'Categories',
+        sellers: 'Sellers',
+        manufacturers: 'Manufacturers',
+        stores: 'Stores',
+        searchCrumb: 'Search',
+        breadcrumb: 'Page path',
+        manufacturerProducts: 'Manufacturer products',
+        sellerProducts: 'Seller products',
+        storeProducts: 'Products in stock at this store',
+        filters: 'Filters',
+        emptyFilters: 'No filters available',
+        blog: 'Journal',
+        emptyBlog: 'No posts yet',
+        minutes: 'min read',
+        loading: 'Loading…',
+        failed: 'Could not load data',
+        retry: 'Retry',
+        previous: 'Previous',
+        next: 'Next',
+        search: 'Search',
+        query: 'Product name (at least 3 characters)',
+        home: 'Home',
+      };
+}

package/templates/lib/orionplace/cartAddress.ts

@@ -0,0 +1,86 @@
+import type { IUserAddress } from '@/interfaces/orionplace/address/IUserAddress';
+import type { ICartAddress } from '@/interfaces/orionplace/cart/ICartData';
+
+type AddressText = Pick<
+  ICartAddress,
+  | 'address_label'
+  | 'line1'
+  | 'line2'
+  | 'city'
+  | 'house_number'
+  | 'entrance'
+  | 'intercom'
+  | 'floor'
+  | 'apt_number'
+  | 'postcode'
+>;
+
+type ComparableAddress = AddressText & {
+  country: { id: number } | null;
+  state: { id: number } | null;
+};
+
+const copiedTextFields: Array<keyof AddressText> = [
+  'address_label',
+  'line1',
+  'line2',
+  'city',
+  'house_number',
+  'entrance',
+  'intercom',
+  'floor',
+  'apt_number',
+  'postcode',
+];
+
+function text(value: string | null | undefined) {
+  return (value ?? '').trim();
+}
+
+function sameAddress(cart: ComparableAddress, saved: ComparableAddress) {
+  if (
+    (cart.country?.id ?? null) !== (saved.country?.id ?? null) ||
+    (cart.state?.id ?? null) !== (saved.state?.id ?? null)
+  ) {
+    return false;
+  }
+
+  return copiedTextFields.every(
+    (field) => text(cart[field]) === text(saved[field]),
+  );
+}
+
+export function matchCartAddress(
+  cartAddress: ICartAddress | null | undefined,
+  savedAddresses: IUserAddress[] | null | undefined,
+) {
+  if (!cartAddress) {
+    return 0;
+  }
+
+  const matches = (savedAddresses ?? []).filter((saved) =>
+    sameAddress(cartAddress, saved),
+  );
+  const chosen =
+    matches.find((saved) => saved.is_default_for_shipping) ?? matches[0];
+  return chosen?.id ?? 0;
+}
+
+/**
+ * Whether the store delivers to the address's country. An address abroad can
+ * be saved, but the backend refuses it as the cart's address or the default.
+ */
+export function canShipTo(address: {
+  country: { is_shipping_country?: boolean } | null;
+}) {
+  return address.country?.is_shipping_country === true;
+}
+
+export function formatCartAddress(address: AddressText) {
+  const street = [text(address.line1), text(address.house_number)]
+    .filter(Boolean)
+    .join(' ');
+  const place = [text(address.city), street].filter(Boolean).join(', ');
+  const label = text(address.address_label);
+  return [label, place].filter(Boolean).join(' · ');
+}

package/templates/lib/orionplace/cartController.ts

@@ -0,0 +1,104 @@
+import { ECartState } from '@/interfaces/orionplace/cart/ICartActions';
+import { cartRequiredOptionsFilled } from '@/lib/orionplace/cartOptions';
+import type {
+  ICartDelivery,
+  ICartGetResponse,
+  ICurrencyAmounts,
+} from '@/interfaces/orionplace/cart/ICartData';
+import type { ICartDeliveryPoint } from '@/interfaces/orionplace/cart/ICartDeliveryActions';
+import type {
+  IOrderCreated,
+  IOrderCreateFailure,
+} from '@/interfaces/orionplace/orders/IOrderActions';
+
+export type StorefrontCartData = NonNullable<ICartGetResponse['page_data']>;
+
+export function cartDataFromResponse(value: unknown): StorefrontCartData {
+  if (
+    !value ||
+    typeof value !== 'object' ||
+    !('cart' in value) ||
+    !('cart_data' in value) ||
+    !('will_not_ship' in value)
+  ) {
+    throw new Error('The cart response is incomplete.');
+  }
+
+  return value as StorefrontCartData;
+}
+
+// `cart_customer_delivery_points_get` answers `page_data.items`.
+export function cartDeliveryPointItems(
+  value: unknown,
+): ICartDeliveryPoint[] | undefined {
+  const items = value && typeof value === 'object' && 'items' in value
+    ? value.items
+    : undefined;
+
+  return Array.isArray(items) ? items as ICartDeliveryPoint[] : undefined;
+}
+
+export function cartIsCheckout(data?: StorefrontCartData): boolean {
+  return data?.cart.state === ECartState.STATE_CHECKOUT;
+}
+
+export function cartDeliveries(data?: StorefrontCartData): ICartDelivery[] {
+  return cartIsCheckout(data) ? (data?.cart_data as ICartDelivery[]) : [];
+}
+
+export function cartOrderReady(data?: StorefrontCartData): boolean {
+  const deliveries = cartDeliveries(data);
+
+  return (
+    Boolean(data?.cart.selected_payment) &&
+    deliveries.length > 0 &&
+    deliveries.every(
+      (delivery) =>
+        delivery.from_store?.virtual_goods === true ||
+        Boolean(delivery.delivery_data.method),
+    ) &&
+    cartRequiredOptionsFilled(deliveries)
+  );
+}
+
+export function cartHasMoney(
+  amounts: ICurrencyAmounts | null | undefined,
+  currencyId: string,
+): boolean {
+  const value = Number(amounts?.[currencyId]?.transform_value);
+
+  return Number.isFinite(value) && value > 0;
+}
+
+export function orderCreatedFromResponse(value: unknown): IOrderCreated {
+  if (
+    !value ||
+    typeof value !== 'object' ||
+    !('order_id' in value) ||
+    !Number.isSafeInteger(value.order_id) ||
+    Number(value.order_id) <= 0
+  ) {
+    throw new Error('The order response does not contain a valid order ID.');
+  }
+
+  return value as IOrderCreated;
+}
+
+export interface StorefrontCartRequestError extends Error {
+  fields?: Record<string, unknown>;
+  data?: IOrderCreateFailure;
+}
+
+export function cartRequestHasFieldErrors(
+  error: unknown,
+): error is StorefrontCartRequestError {
+  if (!error || typeof error !== 'object' || !('fields' in error)) {
+    return false;
+  }
+
+  const fields = error.fields;
+
+  return Boolean(
+    fields && typeof fields === 'object' && Object.keys(fields).length,
+  );
+}