@snabcentr/client-core 4.15.0 → 4.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snabcentr/client-core",
-  "version": "4.15.0",
+  "version": "4.16.0",
   "author": "Snabcentr Ltd.",
   "repository": "https://gitlab.snabcentr.met/web/angular/snabcentr-client-core-lib",
   "license": "Commercial",

package/release_notes.tmp

@@ -1,6 +1,6 @@
-## 4.15.0 (2026-08-14)
+## 4.16.0 (2026-08-17)
 
-### removed (1 change)
+### added (1 change)
 
-- [#13561: Удалён устаревший метод получения списка новых товаров за период](web_soft/libs/angular/snabcentr-client-core-lib@53466f0bfc14308303b2991a1982cae76c8f2a81) ([merge request](web_soft/libs/angular/snabcentr-client-core-lib!339))
+- [#13633: Добавлены общие инструменты пагинации через query-параметр страницы....](web_soft/libs/angular/snabcentr-client-core-lib@ba2b30002f9f5703a5e49c242cc025beed3320bd) ([merge request](web_soft/libs/angular/snabcentr-client-core-lib!340))
 

package/types/snabcentr-client-core.d.ts

@@ -3577,6 +3577,71 @@ interface ScISortOrder<TField = string> {
     direction?: 'asc' | 'desc';
 }
 
+/**
+ * Наименование query-параметра номера страницы пагинации.
+ */
+declare const SC_PAGE_QUERY_PARAM = "page";
+/**
+ * Преобразует значение query-параметра {@link SC_PAGE_QUERY_PARAM} в номер страницы пагинации.
+ * Нечисловые, дробные и меньшие единицы значения приводятся к первой странице.
+ *
+ * @param value Значение query-параметра номера страницы пагинации.
+ */
+declare function scParsePageQueryParam(value?: string | null): number;
+/**
+ * Возвращает {@link Observable} изменения номера страницы пагинации из query-параметра {@link SC_PAGE_QUERY_PARAM}.
+ * Должна вызываться в контексте инъекции.
+ */
+declare function scGetPageQueryParamChanges(): Observable<number>;
+
+/**
+ * Сервис синхронизации номера страницы пагинации с query-параметром {@link SC_PAGE_QUERY_PARAM}.
+ */
+declare class ScPaginationPageQueryParamService<P extends ScIPaginationParams, O extends object = Omit<P, keyof ScIPaginationParams>> {
+    /**
+     * Сервис пагинации.
+     */
+    private readonly paginationService;
+    /**
+     * Сервис предоставляющий доступ к данным о маршруте.
+     */
+    private readonly route;
+    /**
+     * Сервис маршрутизации.
+     */
+    private readonly router;
+    /**
+     * Последние параметры пагинации, переданные в {@link patchOthers}.
+     */
+    private lastParams?;
+    /**
+     * Номер страницы пагинации, применённый последним.
+     */
+    private lastAppliedPage;
+    /**
+     * Инициализирует экземпляр класса {@link ScPaginationPageQueryParamService}.
+     */
+    constructor();
+    /**
+     * Частично обновляет остальные параметры пагинации и применяет номер страницы из query-параметра при первом вызове.
+     *
+     * @param parameters Новые параметры пагинации.
+     */
+    patchOthers(parameters: Partial<O>): void;
+    /**
+     * Применяет количество записей на странице пагинации с сохранением текущей страницы.
+     *
+     * @param perPage Количество записей на странице пагинации.
+     */
+    patchPerPage(perPage: number): void;
+    /**
+     * Убирает номер страницы пагинации из query-параметров.
+     */
+    resetPageQueryParam(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ScPaginationPageQueryParamService<any, any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ScPaginationPageQueryParamService<any, any>>;
+}
+
 /**
  * Тип сопоставления для перевода полей с типом {@link Date} в `string`.
  */
@@ -10398,5 +10463,5 @@ declare class ScVerificationService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ScVerificationService>;
 }
 
-export { CATEGORY_PROVIDERS, EMPTY_CART, IS_BROWSER, IS_RUNNING_ON_TERMINAL, IS_SERVER, SC_ACCESS_AUTH_TOKEN_STORAGE_KEY, SC_API_KEYS, SC_AUTH_ADD_HEADER_REQUIRED, SC_AUTH_AS_CLIENT_DEFAULT_OPTIONS, SC_AUTH_AS_CLIENT_OPTIONS, SC_CACHE_LIFETIME, SC_CACHE_SETTINGS, SC_CATALOG_ITEM_PAGE_META, SC_CATALOG_ROOT_PAGE_META, SC_CATEGORY_INFO, SC_CATEGORY_STATE, SC_COMPANY_INFO, SC_COMPANY_NAME, SC_CONFIGURATOR_COMPONENTS, SC_CONFIGURATOR_SETTINGS, SC_COUNT_FIRST_DISCOUNTED_PRODUCTS, SC_COUNT_LAST_NEWS, SC_DATE_FORMAT, SC_DEFAULT_PAGE_META, SC_FEEDBACK_API, SC_GUEST_ENDPOINTS_TOKEN, SC_GUEST_PARAMETER_NAME_TOKEN, SC_GUEST_TOKEN_STORAGE_KEY, SC_ID_OR_SLUG_IN_ROUTE, SC_IS_HEADER_REQUIRED, SC_IS_HIDDEN_ERROR_ALERT, SC_IS_HIDDEN_ERROR_ALERT_HTTP_CONTEXT, SC_IS_LOGOUT_REQUEST, SC_IS_REFRESH_REQUIRED, SC_LINEAR_VALUES, SC_LINEAR_VALUES_TOKEN, SC_MAX_LENGTH_SEARCH_TERM, SC_MIN_LENGTH_SEARCH_TERM, SC_NEXT_PAGE_PAGINATION_CLICK, SC_ORDER_LOADER, SC_ORDER_LOADING, SC_PATH_IMAGE_NOT_FOUND, SC_PRODUCTS_PAGINATION_LOADER, SC_PRODUCT_PAGINATION_DEFAULT_OPTIONS, SC_PRODUCT_PAGINATION_OPTIONS, SC_REFRESH_AUTH_TOKEN_STORAGE_KEY, SC_RELEASE, SC_SSR_HTTP_TIMEOUT, SC_UPDATE_INTERVAL, SC_URLS, SC_USER_INFO, SC_VACANCIES_DATA_SOURCE, SC_VIRTUAL_CATEGORY_INFO, SC_VIRTUAL_CATEGORY_PROVIDERS, SEARCH_TERM, SEARCH_TERM_PROVIDERS, ScAuthAsClientGuard, ScAuthInterceptor, ScAuthService, ScBanner, ScBannerService, ScCacheInterceptor, ScCacheSettings, ScCachedData, ScCachedItem, ScCart, ScCartService, ScCatalogFilterService, ScCatalogFormat, ScCatalogItem, ScCatalogRedirectService, ScCatalogService, ScCatalogableItem, ScCategory, ScClientType, ScCodedIdentity, ScConfiguratorService, ScContactsService, ScContragentService, ScConvertInterceptor, ScConvertersService, ScDateFormatInterceptor, ScDeletableNamedIdentity, ScDeliveryAddressService, ScDeliveryCost, ScDeliveryType, ScDocumentInfoNode, ScDocumentInfoTypesEnum, ScErrorRequestState, ScErrorsInterceptor, ScFavoriteService, ScFeedbackForms, ScFeedbackService, ScFilesService, ScFrequentlyAskedQuestionsService, ScGuestInterceptor, ScHiddenCatalogableItem, ScIBreadcrumbItem, ScISuggestionType, ScIconTypesEnum, ScIdOrSlugGuard, ScIdOrSlugPipe, ScIdentity, ScImage, ScImageHelper, ScLoadingRequestState, ScLocationsService, ScMediaImageTransformerPipe, ScMimeTypes, ScNamedIdentity, ScNews, ScNewsService, ScNotificationActionTypes, ScNotificationLevelNames, ScNotificationsService, ScOpfList, ScOptionsInterceptor, ScOrder, ScOrderBase, ScOrderDraft, ScOrderDraftShort, ScOrderDraftType, ScOrderDraftsService, ScOrderItem, ScOrderShort, ScOrderStateStatus, ScOrdersService, ScPaginationService, ScPaymentStatus, ScPaymentType, ScPhoneService, ScPrimaryCatalogableItem, ScProduct, ScProductTileType, ScQuestionnaireService, ScQuestionnaireStatusEnum, ScReclamationService, ScReclamationStatus, ScRecommendationService, ScReference, ScReferenceName, ScReferencesService, ScRequestStateStatusEnum, ScRequisitesService, ScRouteKeys, ScSearchService, ScSeoService, ScSocialType, ScSsrTimeoutInterceptor, ScSuccessRequestState, ScSuggestionService, ScSum, ScTokenService, ScUIService, ScUTMService, ScUnitsHelper, ScUpdatableNamedIdentity, ScUploadedFile, ScUser, ScUserMetadata, ScUserMetrikaGoalsEnum, ScUserMetrikaService, ScUserService, ScUserType, ScVCardService, ScVacanciesList, ScVacanciesService, ScVacancy, ScVerificationService, ScVirtualCategory, ScWarehouseService, SchemaOrgFactory, TERMINAL_PROVIDERS, USER_AGENT_TERMINAL, filterChangedByKey, loadingPlaceholder, mapRequestStateToDataOrNull, mapToRequestState, runningOnTerminalFactory, scGetCurrentRoute, scOrderIsLoaded, searchTermFactory };
+export { CATEGORY_PROVIDERS, EMPTY_CART, IS_BROWSER, IS_RUNNING_ON_TERMINAL, IS_SERVER, SC_ACCESS_AUTH_TOKEN_STORAGE_KEY, SC_API_KEYS, SC_AUTH_ADD_HEADER_REQUIRED, SC_AUTH_AS_CLIENT_DEFAULT_OPTIONS, SC_AUTH_AS_CLIENT_OPTIONS, SC_CACHE_LIFETIME, SC_CACHE_SETTINGS, SC_CATALOG_ITEM_PAGE_META, SC_CATALOG_ROOT_PAGE_META, SC_CATEGORY_INFO, SC_CATEGORY_STATE, SC_COMPANY_INFO, SC_COMPANY_NAME, SC_CONFIGURATOR_COMPONENTS, SC_CONFIGURATOR_SETTINGS, SC_COUNT_FIRST_DISCOUNTED_PRODUCTS, SC_COUNT_LAST_NEWS, SC_DATE_FORMAT, SC_DEFAULT_PAGE_META, SC_FEEDBACK_API, SC_GUEST_ENDPOINTS_TOKEN, SC_GUEST_PARAMETER_NAME_TOKEN, SC_GUEST_TOKEN_STORAGE_KEY, SC_ID_OR_SLUG_IN_ROUTE, SC_IS_HEADER_REQUIRED, SC_IS_HIDDEN_ERROR_ALERT, SC_IS_HIDDEN_ERROR_ALERT_HTTP_CONTEXT, SC_IS_LOGOUT_REQUEST, SC_IS_REFRESH_REQUIRED, SC_LINEAR_VALUES, SC_LINEAR_VALUES_TOKEN, SC_MAX_LENGTH_SEARCH_TERM, SC_MIN_LENGTH_SEARCH_TERM, SC_NEXT_PAGE_PAGINATION_CLICK, SC_ORDER_LOADER, SC_ORDER_LOADING, SC_PAGE_QUERY_PARAM, SC_PATH_IMAGE_NOT_FOUND, SC_PRODUCTS_PAGINATION_LOADER, SC_PRODUCT_PAGINATION_DEFAULT_OPTIONS, SC_PRODUCT_PAGINATION_OPTIONS, SC_REFRESH_AUTH_TOKEN_STORAGE_KEY, SC_RELEASE, SC_SSR_HTTP_TIMEOUT, SC_UPDATE_INTERVAL, SC_URLS, SC_USER_INFO, SC_VACANCIES_DATA_SOURCE, SC_VIRTUAL_CATEGORY_INFO, SC_VIRTUAL_CATEGORY_PROVIDERS, SEARCH_TERM, SEARCH_TERM_PROVIDERS, ScAuthAsClientGuard, ScAuthInterceptor, ScAuthService, ScBanner, ScBannerService, ScCacheInterceptor, ScCacheSettings, ScCachedData, ScCachedItem, ScCart, ScCartService, ScCatalogFilterService, ScCatalogFormat, ScCatalogItem, ScCatalogRedirectService, ScCatalogService, ScCatalogableItem, ScCategory, ScClientType, ScCodedIdentity, ScConfiguratorService, ScContactsService, ScContragentService, ScConvertInterceptor, ScConvertersService, ScDateFormatInterceptor, ScDeletableNamedIdentity, ScDeliveryAddressService, ScDeliveryCost, ScDeliveryType, ScDocumentInfoNode, ScDocumentInfoTypesEnum, ScErrorRequestState, ScErrorsInterceptor, ScFavoriteService, ScFeedbackForms, ScFeedbackService, ScFilesService, ScFrequentlyAskedQuestionsService, ScGuestInterceptor, ScHiddenCatalogableItem, ScIBreadcrumbItem, ScISuggestionType, ScIconTypesEnum, ScIdOrSlugGuard, ScIdOrSlugPipe, ScIdentity, ScImage, ScImageHelper, ScLoadingRequestState, ScLocationsService, ScMediaImageTransformerPipe, ScMimeTypes, ScNamedIdentity, ScNews, ScNewsService, ScNotificationActionTypes, ScNotificationLevelNames, ScNotificationsService, ScOpfList, ScOptionsInterceptor, ScOrder, ScOrderBase, ScOrderDraft, ScOrderDraftShort, ScOrderDraftType, ScOrderDraftsService, ScOrderItem, ScOrderShort, ScOrderStateStatus, ScOrdersService, ScPaginationPageQueryParamService, ScPaginationService, ScPaymentStatus, ScPaymentType, ScPhoneService, ScPrimaryCatalogableItem, ScProduct, ScProductTileType, ScQuestionnaireService, ScQuestionnaireStatusEnum, ScReclamationService, ScReclamationStatus, ScRecommendationService, ScReference, ScReferenceName, ScReferencesService, ScRequestStateStatusEnum, ScRequisitesService, ScRouteKeys, ScSearchService, ScSeoService, ScSocialType, ScSsrTimeoutInterceptor, ScSuccessRequestState, ScSuggestionService, ScSum, ScTokenService, ScUIService, ScUTMService, ScUnitsHelper, ScUpdatableNamedIdentity, ScUploadedFile, ScUser, ScUserMetadata, ScUserMetrikaGoalsEnum, ScUserMetrikaService, ScUserService, ScUserType, ScVCardService, ScVacanciesList, ScVacanciesService, ScVacancy, ScVerificationService, ScVirtualCategory, ScWarehouseService, SchemaOrgFactory, TERMINAL_PROVIDERS, USER_AGENT_TERMINAL, filterChangedByKey, loadingPlaceholder, mapRequestStateToDataOrNull, mapToRequestState, runningOnTerminalFactory, scGetCurrentRoute, scGetPageQueryParamChanges, scOrderIsLoaded, scParsePageQueryParam, searchTermFactory };
 export type { IAuthToken, ILogin, IPhoneCheck, IPhoneLogin, ISandwichCalculate, ISandwichCalculateItem, IToken, RobotsTagType, ScApprovedData, ScAuthAsClientOptions, ScCatalogFilter, ScContactRelationOnDataCreate, ScContragent, ScContragentEntrepreneurOnDataCreate, ScContragentIndividualOnDataCreate, ScContragentLegalOnDataCreate, ScContragentNonResidentLegalOnDataCreate, ScContragentOnDataCreate, ScDateToString, ScDocumentInfo, ScFaqGroup, ScFaqItem, ScFiltersTreeCatalog, ScIApiErrorResponse, ScIApiKeys, ScIAppRelease, ScIBank, ScIBankAccount, ScIBankAccountOnDataCreate, ScIBanner, ScIBaseCatalogFilter, ScICacheLifetime, ScICart, ScICatalogItem, ScICatalogPaginationParams, ScICatalogableItem, ScICategory, ScICategoryProductPaginationParams, ScICategoryProductParams, ScIChangePassword, ScICheckboxFilter, ScICity, ScICityWithRegion, ScICityWithRegionAndCountry, ScICodedIdentity, ScICompanyBaseInfo, ScIConfiguratorBase, ScIConfiguratorCalculateResult, ScIConfiguratorCalculateSheet, ScIConfiguratorSearchProductBase, ScIConfiguratorSettingsBase, ScIContact, ScIContactAndMedia, ScIContactBase, ScIContactOnDataCreate, ScIContactRelation, ScIContactWithRelations, ScIContragentEntrepreneur, ScIContragentIndividual, ScIContragentLegal, ScIContragentNonResidentLegal, ScICountry, ScICreatedAt, ScICurrency, ScIDateFormat, ScIDatePeriod, ScIDefaultPageMeta, ScIDeletableNamedIdentity, ScIDeletedAt, ScIDeliveryAddress, ScIDeliveryAddressOnDataCreate, ScIDeliveryCostDTO, ScIDirectionManagerContact, ScIDiscount, ScIEmployment, ScIExperience, ScIFeedbackAPI, ScIFeedbackMessage, ScIFile, ScIFilterTreeCategory, ScIFrequentlyAskedQuestionsPaginationParams, ScIHiddenCatalogableItem, ScIIdentity, ScIImage, ScIManager, ScIMapsDefaultOptions, ScINamed, ScINamedIdentity, ScINewCartItemMeasured, ScINewOrder, ScINewOrderDraftRequest, ScINewOrderItemBase, ScINews, ScINewsTile, ScINotificationsCount, ScIOpf, ScIOrder, ScIOrderBase, ScIOrderDelivery, ScIOrderDraft, ScIOrderDraftListParams, ScIOrderDraftShort, ScIOrderEditorLoader, ScIOrderHistory, ScIOrderHistoryUser, ScIOrderItem, ScIOrderLoader, ScIOrderPayment, ScIOrderShort, ScIOrgContact, ScIPaginate, ScIPaginationLinks, ScIPaginationMeta, ScIPaginationParams, ScIParentCategoryRedirect, ScIPasswordOnDataUpdate, ScIPhoneOnDataApprove, ScIPrimaryCatalogableItem, ScIProduct, ScIProductImages, ScIProductNotifyWhenInStock, ScIProductUnit, ScIProperties, ScIQuestionAnswer, ScIQuestionPossibleAnswer, ScIQuestionnaire, ScIQuestionnaireQuestion, ScIRangeFilter, ScIReclamation, ScIReclamationItem, ScIReclamationOnDataCreate, ScIReclamationOnDataCreateItem, ScIReclamationPaginationParams, ScIReclamationShort, ScIReference, ScIReferencesTypes, ScIRegion, ScIRegionWithCities, ScIRegionWithCountry, ScIRequestState, ScIRequisites, ScIRequisitesWithLabel, ScIRetailContact, ScISalary, ScISalesDirection, ScISeo, ScISeoResource, ScISimpleSearch, ScISimpleUserOnDataCreate, ScISocialMedia, ScISortOrder, ScISuggestionAddress, ScISuggestionBank, ScISuggestionEmail, ScISuggestionFIO, ScISuggestionOrganization, ScITerminalProvider, ScITypedClassProvider, ScITypedNullableRange, ScITypedValueProvider, ScIUpdatableNamedIdentity, ScIUpdateInterval, ScIUpdateOrderDraftRequest, ScIUpdatedAt, ScIUrls, ScIUserConfigs, ScIUserDTO, ScIUserMetrikaEvent, ScIUserNotification, ScIUserOnDataCreate, ScIUserOnDataUpdate, ScIVacanciesDataSource, ScIVirtualCategory, ScIWarehouse, ScIWarehouseStockCount, ScOrderLoading, ScPriceHistory, ScProductsPaginationLoader, ScPropertyFilters, ScProvider, ScRangeFilter, ScSuggestion, ScTProductSortField, ScToggleFilter, ScTypeByKey, ScUTM, ScUTMParams };