@nextgis/ngw-connector 2.5.0 → 3.0.0-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/lib/index.d.ts CHANGED
@@ -1,7 +1,6 @@
1
1
  /// <reference types="node" />
2
2
  import { EventEmitter } from 'events';
3
3
  import Cache from '@nextgis/cache';
4
- import CancelablePromise from '@nextgis/cancelable-promise';
5
4
  import { FeatureProperties, DeepPartial } from '@nextgis/utils';
6
5
  import { GeoJsonObject, Geometry } from 'geojson';
7
6
 
@@ -926,7 +925,7 @@ interface GetChildrenOfOptions extends Pick<RequestOptions, 'cache'> {
926
925
  }
927
926
 
928
927
  declare class ResourcesControl {
929
- cache: Cache<CancelablePromise<ResourceItem | undefined>, {
928
+ cache: Cache<Promise<ResourceItem | undefined>, {
930
929
  id?: number | string;
931
930
  }>;
932
931
  connector: NgwConnector;
@@ -941,8 +940,8 @@ declare class ResourcesControl {
941
940
  * @remarks
942
941
  * Fetching resource would be cached to speed up next call
943
942
  */
944
- getOne(resource: ResourceDefinition, requestOptions?: RequestOptions<'GET'>): CancelablePromise<ResourceItem | undefined>;
945
- getOneOrFail(resource: ResourceDefinition, requestOptions?: RequestOptions<'GET'>): CancelablePromise<ResourceItem>;
943
+ getOne(resource: ResourceDefinition, requestOptions?: RequestOptions<'GET'>): Promise<ResourceItem | undefined>;
944
+ getOneOrFail(resource: ResourceDefinition, requestOptions?: RequestOptions<'GET'>): Promise<ResourceItem>;
946
945
  /**
947
946
  * A fast way to retrieve resource ID for any resource definition.
948
947
  * @param resource - Any available resource definition
@@ -953,7 +952,7 @@ declare class ResourcesControl {
953
952
  * then this method will come in handy to facilitate the extraction of the identifier
954
953
  * if the resource is specified through a keyname or other parameters.
955
954
  */
956
- getId(resource: ResourceDefinition, requestOptions?: RequestOptions<'GET'>): CancelablePromise<number | undefined>;
955
+ getId(resource: ResourceDefinition, requestOptions?: RequestOptions<'GET'>): Promise<number | undefined>;
957
956
  /**
958
957
  * A fast way to retrieve resource ID for any resource definition.
959
958
  * @param resource - Any available resource definition
@@ -962,16 +961,16 @@ declare class ResourcesControl {
962
961
  * Similar with {@link NgwConnector.getResourceId | getResourceId} but rise error if resource is not exist.
963
962
  * To not make one more checks if the resource is definitely exists
964
963
  */
965
- getIdOrFail(resource: ResourceDefinition, requestOptions?: RequestOptions<'GET'>): CancelablePromise<number>;
966
- getMany(resource: DeepPartial<Resource>, requestOptions?: RequestOptions<'GET'>): CancelablePromise<ResourceItem[]>;
967
- getParent(resource: ResourceDefinition, requestOptions?: RequestOptions<'GET'>): CancelablePromise<ResourceItem | undefined>;
968
- getChildrenOf(resource: ResourceDefinition, requestOptions?: GetChildrenOfOptions): CancelablePromise<ResourceItem[]>;
969
- update(resource: ResourceDefinition, data: DeepPartial<ResourceItem>): CancelablePromise<ResourceItem | undefined>;
964
+ getIdOrFail(resource: ResourceDefinition, requestOptions?: RequestOptions<'GET'>): Promise<number>;
965
+ getMany(resource: DeepPartial<Resource>, requestOptions?: RequestOptions<'GET'>): Promise<ResourceItem[]>;
966
+ getParent(resource: ResourceDefinition, requestOptions?: RequestOptions<'GET'>): Promise<ResourceItem | undefined>;
967
+ getChildrenOf(resource: ResourceDefinition, requestOptions?: GetChildrenOfOptions): Promise<ResourceItem[]>;
968
+ update(resource: ResourceDefinition, data: DeepPartial<ResourceItem>): Promise<ResourceItem | undefined>;
970
969
  /**
971
970
  * Fast way to delete resource from NGW and clean cache.
972
971
  * @param resource - Resource definition
973
972
  */
974
- delete(resource: ResourceDefinition): CancelablePromise<void>;
973
+ delete(resource: ResourceDefinition): Promise<void>;
975
974
  private _getChildrenOf;
976
975
  private _cleanResourceItemCache;
977
976
  private _fetchResourceById;
@@ -1044,17 +1043,17 @@ declare class NgwConnector {
1044
1043
  * .catch((er) => console.log('Connection problem', er));
1045
1044
  * ```
1046
1045
  */
1047
- connect(): CancelablePromise<PyramidRoute>;
1046
+ connect(): Promise<PyramidRoute>;
1048
1047
  /**
1049
1048
  * Quick way to change NextGIS Web user.
1050
1049
  * @param credentials - New user credentials
1051
1050
  */
1052
- login(credentials: Credentials, options?: RequestOptions): CancelablePromise<UserInfo>;
1051
+ login(credentials: Credentials, options?: RequestOptions): Promise<UserInfo>;
1053
1052
  /**
1054
1053
  * Disconnecting a user. Aborting all current requests
1055
1054
  */
1056
1055
  logout(): void;
1057
- getUserInfo(credentials?: Credentials, options?: RequestOptions): CancelablePromise<UserInfo>;
1056
+ getUserInfo(credentials?: Credentials, options?: RequestOptions): Promise<UserInfo>;
1058
1057
  /**
1059
1058
  * Obtaining the required Headers for authentication of requests in the NGW.
1060
1059
  */
@@ -1062,7 +1061,9 @@ declare class NgwConnector {
1062
1061
  makeClientId(credentials?: Credentials): string | undefined;
1063
1062
  /** Stop all api requests */
1064
1063
  abort(): void;
1065
- getActiveApiRequests(): CancelablePromise<any>[];
1064
+ getActiveApiRequests(): {
1065
+ [x: number]: AbortController;
1066
+ };
1066
1067
  /**
1067
1068
  * Send request to NGW api router.
1068
1069
  * @param name - NGW route name from {@link https://docs.nextgis.com/docs_ngweb_dev/doc/developer/resource.html#routes | routes}
@@ -1092,7 +1093,7 @@ declare class NgwConnector {
1092
1093
  *
1093
1094
  * ```
1094
1095
  */
1095
- apiRequest<K extends keyof RequestItemsParamsMap, P extends RequestItemKeys = RequestItemKeys>(name: K, params_?: RequestItemsParams<K>, requestOptions?: RequestOptions): CancelablePromise<P[K]>;
1096
+ apiRequest<K extends keyof RequestItemsParamsMap, P extends RequestItemKeys = RequestItemKeys>(name: K, params_?: RequestItemsParams<K>, requestOptions?: RequestOptions): Promise<P[K]>;
1096
1097
  /**
1097
1098
  * Shortcut method for send POST request to NGW.
1098
1099
  * @param name - NGW route name from {@link https://docs.nextgis.com/docs_ngweb_dev/doc/developer/resource.html#routes | routes}
@@ -1106,92 +1107,92 @@ declare class NgwConnector {
1106
1107
  * .catch((error) => console.warn(error));
1107
1108
  * ```
1108
1109
  */
1109
- post<K extends keyof RequestItemsParamsMap>(name: K, options?: RequestOptions<'POST', K>, params?: RequestItemsParams<K>): CancelablePromise<PostRequestItemsResponseMap[K]>;
1110
+ post<K extends keyof RequestItemsParamsMap>(name: K, options?: RequestOptions<'POST', K>, params?: RequestItemsParams<K>): Promise<PostRequestItemsResponseMap[K]>;
1110
1111
  /**
1111
1112
  * Shortcut method for send GET request to NGW.
1112
1113
  * @param name - NGW route name from {@link https://docs.nextgis.com/docs_ngweb_dev/doc/developer/resource.html#routes | routes}
1113
1114
  * @param options - Request options
1114
1115
  * @param params - Request item params or query params
1115
1116
  */
1116
- get<K extends keyof RequestItemsParamsMap>(name: K, options?: RequestOptions<'GET', K> | undefined | null, params?: RequestItemsParams<K>): CancelablePromise<GetRequestItemsResponseMap[K]>;
1117
+ get<K extends keyof RequestItemsParamsMap>(name: K, options?: RequestOptions<'GET', K> | undefined | null, params?: RequestItemsParams<K>): Promise<GetRequestItemsResponseMap[K]>;
1117
1118
  /**
1118
1119
  * Shortcut method for send PATCH request to NGW.
1119
1120
  * @param name - NGW route name from {@link https://docs.nextgis.com/docs_ngweb_dev/doc/developer/resource.html#routes | routes}
1120
1121
  * @param options - Request options
1121
1122
  * @param params - Request item params or query params
1122
1123
  */
1123
- patch<K extends keyof RequestItemsParamsMap>(name: K, options?: RequestOptions<'PATCH', K>, params?: RequestItemsParams<K>): CancelablePromise<PatchRequestItemsResponseMap[K]>;
1124
+ patch<K extends keyof RequestItemsParamsMap>(name: K, options?: RequestOptions<'PATCH', K>, params?: RequestItemsParams<K>): Promise<PatchRequestItemsResponseMap[K]>;
1124
1125
  /**
1125
1126
  * Shortcut method for send PUT request to NGW.
1126
1127
  * @param name - NGW route name from {@link https://docs.nextgis.com/docs_ngweb_dev/doc/developer/resource.html#routes | routes}
1127
1128
  * @param options - Request options
1128
1129
  * @param params - Request item params or query params
1129
1130
  */
1130
- put<K extends keyof RequestItemsParamsMap>(name: K, options?: RequestOptions<'PUT', K>, params?: RequestItemsParams<K>): CancelablePromise<PutRequestItemsResponseMap[K]>;
1131
+ put<K extends keyof RequestItemsParamsMap>(name: K, options?: RequestOptions<'PUT', K>, params?: RequestItemsParams<K>): Promise<PutRequestItemsResponseMap[K]>;
1131
1132
  /**
1132
1133
  * Shortcut method for send DELETE request to NGW.
1133
1134
  * @param name - NGW route name from {@link https://docs.nextgis.com/docs_ngweb_dev/doc/developer/resource.html#routes | routes}
1134
1135
  * @param options - Request options
1135
1136
  * @param params - Request item params or query params
1136
1137
  */
1137
- delete<K extends keyof RequestItemsParamsMap>(name: K, options?: RequestOptions<'DELETE', K> | undefined | null, params?: RequestItemsParams<K>): CancelablePromise<DeleteRequestItemsResponseMap[K]>;
1138
+ delete<K extends keyof RequestItemsParamsMap>(name: K, options?: RequestOptions<'DELETE', K> | undefined | null, params?: RequestItemsParams<K>): Promise<DeleteRequestItemsResponseMap[K]>;
1138
1139
  /**
1139
1140
  * Send request to NGW.
1140
1141
  * @param url - URL address to NGW
1141
1142
  * @param params - Query params
1142
1143
  * @param options - Request options
1143
1144
  */
1144
- makeQuery<R = unknown>(url: string, params?: Params | null, options?: RequestOptions): CancelablePromise<R>;
1145
+ makeQuery<R = unknown>(url: string, params?: Params | null, options?: RequestOptions): Promise<R>;
1145
1146
  /**
1146
1147
  * {@link ResourcesControl.getOne}
1147
1148
  */
1148
- getResource(resource: ResourceDefinition, requestOptions?: RequestOptions<'GET'>): CancelablePromise<ResourceItem | undefined>;
1149
+ getResource(resource: ResourceDefinition, requestOptions?: RequestOptions<'GET'>): Promise<ResourceItem | undefined>;
1149
1150
  /**
1150
1151
  * {@link ResourcesControl.getOneOrFail}
1151
1152
  */
1152
- getResourceOrFail(resource: ResourceDefinition, requestOptions?: RequestOptions<'GET'>): CancelablePromise<ResourceItem>;
1153
+ getResourceOrFail(resource: ResourceDefinition, requestOptions?: RequestOptions<'GET'>): Promise<ResourceItem>;
1153
1154
  /**
1154
1155
  * @deprecated - use {@link getResource}
1155
1156
  */
1156
- getResourceBy(resource: DeepPartial<Resource>): CancelablePromise<ResourceItem | undefined>;
1157
+ getResourceBy(resource: DeepPartial<Resource>): Promise<ResourceItem | undefined>;
1157
1158
  /**
1158
1159
  * @deprecated - use {@link getResource}
1159
1160
  */
1160
- getResourceByKeyname(keyname: string): CancelablePromise<ResourceItem | undefined>;
1161
+ getResourceByKeyname(keyname: string): Promise<ResourceItem | undefined>;
1161
1162
  /**
1162
1163
  * @deprecated - use {@link getResource}
1163
1164
  */
1164
- getResourceById(id: number): CancelablePromise<ResourceItem | undefined>;
1165
+ getResourceById(id: number): Promise<ResourceItem | undefined>;
1165
1166
  /**
1166
1167
  * {@link ResourcesControl.getId}
1167
1168
  */
1168
- getResourceId(resource: ResourceDefinition, requestOptions?: RequestOptions<'GET'>): CancelablePromise<number | undefined>;
1169
+ getResourceId(resource: ResourceDefinition, requestOptions?: RequestOptions<'GET'>): Promise<number | undefined>;
1169
1170
  /**
1170
1171
  * {@link ResourcesControl.getIdOrFail}
1171
1172
  */
1172
- getResourceIdOrFail(resource: ResourceDefinition, requestOptions?: RequestOptions<'GET'>): CancelablePromise<number>;
1173
+ getResourceIdOrFail(resource: ResourceDefinition, requestOptions?: RequestOptions<'GET'>): Promise<number>;
1173
1174
  /**
1174
1175
  * {@link ResourcesControl.getMany}
1175
1176
  */
1176
- getResourcesBy(resource: DeepPartial<Resource>, requestOptions?: RequestOptions<'GET'>): CancelablePromise<ResourceItem[]>;
1177
+ getResourcesBy(resource: DeepPartial<Resource>, requestOptions?: RequestOptions<'GET'>): Promise<ResourceItem[]>;
1177
1178
  /**
1178
1179
  * {@link ResourcesControl.getParent}
1179
1180
  */
1180
- getResourceParent(resource: ResourceDefinition, requestOptions?: RequestOptions<'GET'>): CancelablePromise<ResourceItem | undefined>;
1181
+ getResourceParent(resource: ResourceDefinition, requestOptions?: RequestOptions<'GET'>): Promise<ResourceItem | undefined>;
1181
1182
  /**
1182
1183
  * {@link ResourcesControl.getChildrenOf}
1183
1184
  */
1184
- getResourceChildren(resource: ResourceDefinition, requestOptions?: GetChildrenOfOptions): CancelablePromise<ResourceItem[]>;
1185
+ getResourceChildren(resource: ResourceDefinition, requestOptions?: GetChildrenOfOptions): Promise<ResourceItem[]>;
1185
1186
  /**
1186
1187
  * {@link ResourcesControl.update}
1187
1188
  */
1188
- updateResource(resource: ResourceIdKeynameDef, data: DeepPartial<ResourceItem>): CancelablePromise<ResourceItem | undefined>;
1189
+ updateResource(resource: ResourceIdKeynameDef, data: DeepPartial<ResourceItem>): Promise<ResourceItem | undefined>;
1189
1190
  /**
1190
1191
  * {@link ResourcesControl.delete}
1191
1192
  */
1192
- deleteResource(resource: ResourceIdKeynameDef): CancelablePromise<void>;
1193
+ deleteResource(resource: ResourceIdKeynameDef): Promise<void>;
1193
1194
  private _login;
1194
- private _cleanActiveRequests;
1195
+ private _cleanActiveRequest;
1195
1196
  private _handleHttpError;
1196
1197
  }
1197
1198