mahal_map 1.7.2 → 1.7.3

package/dist/index.d.mts

@@ -202,6 +202,13 @@ interface ISearchResponse {
         number: string;
     } | [];
 }
+interface ICheckJSApiParam {
+    token: string;
+}
+interface ICheckJSApiResponse {
+    success: boolean;
+    message: string;
+}
 
 interface IResponse<T> {
     success: boolean;
@@ -244,6 +251,22 @@ declare class MahalMap {
     private static getVectorStyle;
     private static getMapToken;
     private static getMaps3DCtor;
+    /**
+     * Проверяет подписку JSApi перед созданием карты. Нужна только для legacy-движка
+     * (mtile.gram.tj): у engine: "3d" (GramMaps, navi.gram.tj) доступ контролирует сама
+     * платформа по ?key=, отдельная проверка там не применяется и пропускается.
+     *
+     * Fail-open: блокирует создание карты только при явном ответе сервиса success:false.
+     * Сетевая ошибка (сервис недоступен, CORS, таймаут) карту не роняет — иначе падение
+     * geocode.mahal.tj гасит карты у всех клиентов.
+     */
+    private static ensureJSApiSubscription;
+    /**
+     * Асинхронный аналог create(): для engine: "legacy" сначала дожидается проверки подписки
+     * JSApi и, если её нет, не создаёт карту вообще (MapLibre-инстанс не строится).
+     * Для engine: "3d" — тот же create() без проверки.
+     */
+    static createAsync(options: IMahalMapOptions, maplibreObject?: MapLibreApi, maps3dCtor?: Maps3DCtor): Promise<MahalMap>;
     static create(options: IMahalMapOptions, maplibreObject?: MapLibreApi, maps3dCtor?: Maps3DCtor): MahalMap;
     static onReady(container: string, callback: (map: Map) => void): void;
     static getInstance(container: string): MahalMap;
@@ -312,16 +335,20 @@ declare const getApiKey: () => string;
 declare function Router(param: number[][], typeData: string, token: string): Promise<IRoute[]>;
 
 declare function Search(param: string, token: string, additionalParam?: IAdditionalParamType): Promise<ISearchResponse[]>;
+declare function SearchPoi(param: string, token: string, additionalParam?: IAdditionalParamType): Promise<ISearchResponse[]>;
 declare function SearchByLocation(params: ISearchByLocationParam): Promise<ISearchResponse>;
+declare function CheckJSApi(token: string): Promise<ICheckJSApiResponse>;
 
+declare const index$2_CheckJSApi: typeof CheckJSApi;
 declare const index$2_Router: typeof Router;
 declare const index$2_Search: typeof Search;
 declare const index$2_SearchByLocation: typeof SearchByLocation;
+declare const index$2_SearchPoi: typeof SearchPoi;
 declare const index$2_clearKey: typeof clearKey;
 declare const index$2_getApiKey: typeof getApiKey;
 declare const index$2_saveKey: typeof saveKey;
 declare namespace index$2 {
-  export { index$2_Router as Router, index$2_Search as Search, index$2_SearchByLocation as SearchByLocation, index$2_clearKey as clearKey, index$2_getApiKey as getApiKey, index$2_saveKey as saveKey };
+  export { index$2_CheckJSApi as CheckJSApi, index$2_Router as Router, index$2_Search as Search, index$2_SearchByLocation as SearchByLocation, index$2_SearchPoi as SearchPoi, index$2_clearKey as clearKey, index$2_getApiKey as getApiKey, index$2_saveKey as saveKey };
 }
 
 declare class MahalMapDefaultMarker {
@@ -566,4 +593,4 @@ declare namespace index {
   export { index_checkCoordinates as checkCoordinates, index_debounce as debounce, index_geojsonPolyline as geojsonPolyline, index_geometryPolyline as geometryPolyline, index_trimValue as trimValue };
 }
 
-export { type IAdditionalParamType, type IMahalMapOptions, type IMapMarker, type IMaps3DBuildingClickInfo, type IMaps3DBuildingsController, type IMaps3DLayer, type IMaps3DLayerOptions, type IMaps3DObjectsLightOptions, type IMaps3DTrafficOptions, type IResponse, type IRoute, type ISearchByLocationParam, type ISearchParam, type ISearchResponse, MahalMap, MahalMapDefaultMarker, type MahalMapDefaultMarkerProps, type MapEngine, type MapLanguage, type Maps3DCtor, type Maps3DTransformRequest, type MeasureIcons, type MeasureLabels, type MeasureMode, type MeasurePoint, type MeasureShape, type MeasureState, type MeasureStyleOptions, MeasureTool, type MeasureToolOptions, Router, Search, SearchByLocation, type Theme, index$2 as keyUtils, index$1 as measureUtils, index as utils };
+export { CheckJSApi, type IAdditionalParamType, type ICheckJSApiParam, type ICheckJSApiResponse, type IMahalMapOptions, type IMapMarker, type IMaps3DBuildingClickInfo, type IMaps3DBuildingsController, type IMaps3DLayer, type IMaps3DLayerOptions, type IMaps3DObjectsLightOptions, type IMaps3DTrafficOptions, type IResponse, type IRoute, type ISearchByLocationParam, type ISearchParam, type ISearchResponse, MahalMap, MahalMapDefaultMarker, type MahalMapDefaultMarkerProps, type MapEngine, type MapLanguage, type Maps3DCtor, type Maps3DTransformRequest, type MeasureIcons, type MeasureLabels, type MeasureMode, type MeasurePoint, type MeasureShape, type MeasureState, type MeasureStyleOptions, MeasureTool, type MeasureToolOptions, Router, Search, SearchByLocation, SearchPoi, type Theme, index$2 as keyUtils, index$1 as measureUtils, index as utils };

package/dist/index.d.ts

@@ -202,6 +202,13 @@ interface ISearchResponse {
         number: string;
     } | [];
 }
+interface ICheckJSApiParam {
+    token: string;
+}
+interface ICheckJSApiResponse {
+    success: boolean;
+    message: string;
+}
 
 interface IResponse<T> {
     success: boolean;
@@ -244,6 +251,22 @@ declare class MahalMap {
     private static getVectorStyle;
     private static getMapToken;
     private static getMaps3DCtor;
+    /**
+     * Проверяет подписку JSApi перед созданием карты. Нужна только для legacy-движка
+     * (mtile.gram.tj): у engine: "3d" (GramMaps, navi.gram.tj) доступ контролирует сама
+     * платформа по ?key=, отдельная проверка там не применяется и пропускается.
+     *
+     * Fail-open: блокирует создание карты только при явном ответе сервиса success:false.
+     * Сетевая ошибка (сервис недоступен, CORS, таймаут) карту не роняет — иначе падение
+     * geocode.mahal.tj гасит карты у всех клиентов.
+     */
+    private static ensureJSApiSubscription;
+    /**
+     * Асинхронный аналог create(): для engine: "legacy" сначала дожидается проверки подписки
+     * JSApi и, если её нет, не создаёт карту вообще (MapLibre-инстанс не строится).
+     * Для engine: "3d" — тот же create() без проверки.
+     */
+    static createAsync(options: IMahalMapOptions, maplibreObject?: MapLibreApi, maps3dCtor?: Maps3DCtor): Promise<MahalMap>;
     static create(options: IMahalMapOptions, maplibreObject?: MapLibreApi, maps3dCtor?: Maps3DCtor): MahalMap;
     static onReady(container: string, callback: (map: Map) => void): void;
     static getInstance(container: string): MahalMap;
@@ -312,16 +335,20 @@ declare const getApiKey: () => string;
 declare function Router(param: number[][], typeData: string, token: string): Promise<IRoute[]>;
 
 declare function Search(param: string, token: string, additionalParam?: IAdditionalParamType): Promise<ISearchResponse[]>;
+declare function SearchPoi(param: string, token: string, additionalParam?: IAdditionalParamType): Promise<ISearchResponse[]>;
 declare function SearchByLocation(params: ISearchByLocationParam): Promise<ISearchResponse>;
+declare function CheckJSApi(token: string): Promise<ICheckJSApiResponse>;
 
+declare const index$2_CheckJSApi: typeof CheckJSApi;
 declare const index$2_Router: typeof Router;
 declare const index$2_Search: typeof Search;
 declare const index$2_SearchByLocation: typeof SearchByLocation;
+declare const index$2_SearchPoi: typeof SearchPoi;
 declare const index$2_clearKey: typeof clearKey;
 declare const index$2_getApiKey: typeof getApiKey;
 declare const index$2_saveKey: typeof saveKey;
 declare namespace index$2 {
-  export { index$2_Router as Router, index$2_Search as Search, index$2_SearchByLocation as SearchByLocation, index$2_clearKey as clearKey, index$2_getApiKey as getApiKey, index$2_saveKey as saveKey };
+  export { index$2_CheckJSApi as CheckJSApi, index$2_Router as Router, index$2_Search as Search, index$2_SearchByLocation as SearchByLocation, index$2_SearchPoi as SearchPoi, index$2_clearKey as clearKey, index$2_getApiKey as getApiKey, index$2_saveKey as saveKey };
 }
 
 declare class MahalMapDefaultMarker {
@@ -566,4 +593,4 @@ declare namespace index {
   export { index_checkCoordinates as checkCoordinates, index_debounce as debounce, index_geojsonPolyline as geojsonPolyline, index_geometryPolyline as geometryPolyline, index_trimValue as trimValue };
 }
 
-export { type IAdditionalParamType, type IMahalMapOptions, type IMapMarker, type IMaps3DBuildingClickInfo, type IMaps3DBuildingsController, type IMaps3DLayer, type IMaps3DLayerOptions, type IMaps3DObjectsLightOptions, type IMaps3DTrafficOptions, type IResponse, type IRoute, type ISearchByLocationParam, type ISearchParam, type ISearchResponse, MahalMap, MahalMapDefaultMarker, type MahalMapDefaultMarkerProps, type MapEngine, type MapLanguage, type Maps3DCtor, type Maps3DTransformRequest, type MeasureIcons, type MeasureLabels, type MeasureMode, type MeasurePoint, type MeasureShape, type MeasureState, type MeasureStyleOptions, MeasureTool, type MeasureToolOptions, Router, Search, SearchByLocation, type Theme, index$2 as keyUtils, index$1 as measureUtils, index as utils };
+export { CheckJSApi, type IAdditionalParamType, type ICheckJSApiParam, type ICheckJSApiResponse, type IMahalMapOptions, type IMapMarker, type IMaps3DBuildingClickInfo, type IMaps3DBuildingsController, type IMaps3DLayer, type IMaps3DLayerOptions, type IMaps3DObjectsLightOptions, type IMaps3DTrafficOptions, type IResponse, type IRoute, type ISearchByLocationParam, type ISearchParam, type ISearchResponse, MahalMap, MahalMapDefaultMarker, type MahalMapDefaultMarkerProps, type MapEngine, type MapLanguage, type Maps3DCtor, type Maps3DTransformRequest, type MeasureIcons, type MeasureLabels, type MeasureMode, type MeasurePoint, type MeasureShape, type MeasureState, type MeasureStyleOptions, MeasureTool, type MeasureToolOptions, Router, Search, SearchByLocation, SearchPoi, type Theme, index$2 as keyUtils, index$1 as measureUtils, index as utils };