@xyo-network/api 4.1.1 → 4.1.3

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.
@@ -1,196 +1,7 @@
1
- import * as _xyo_network_payload_model from '@xyo-network/payload-model';
2
- import { Payload, PayloadFindFilter } from '@xyo-network/payload-model';
3
- import { ApiConfig, ApiReportable, ApiError, ApiResponse, ApiResponseBody, ApiResponseTuple, ApiEnvelope } from '@xyo-network/api-models';
4
- import { Huri } from '@xyo-network/huri';
5
- import { AxiosJson } from '@xylabs/axios';
6
- import { DivinerConfig } from '@xyo-network/diviner-model';
7
-
8
- declare class ApiBase<C extends ApiConfig = ApiConfig> implements ApiReportable {
9
- readonly config: C;
10
- protected axios: AxiosJson;
11
- constructor(config: C);
12
- get authenticated(): boolean;
13
- protected get headers(): Record<string, string>;
14
- protected get query(): string;
15
- protected get root(): string;
16
- private static resolveResponse;
17
- private static shapeResponse;
18
- onError(error: ApiError, depth?: number): void;
19
- onFailure(response: ApiResponse, depth?: number): void;
20
- onSuccess(response: ApiResponse, depth?: number): void;
21
- protected deleteEndpoint<T = unknown>(endPoint?: string): Promise<ApiResponseBody<T>>;
22
- protected deleteEndpoint<T = unknown>(endPoint?: string, responseType?: 'body'): Promise<ApiResponseBody<T>>;
23
- protected deleteEndpoint<T = unknown>(endPoint?: string, responseType?: 'tuple'): Promise<ApiResponseTuple<T>>;
24
- protected getEndpoint<T = unknown>(endPoint?: string): Promise<ApiResponseBody<T>>;
25
- protected getEndpoint<T = unknown>(endPoint?: string, responseType?: 'body'): Promise<ApiResponseBody<T>>;
26
- protected getEndpoint<T = unknown>(endPoint?: string, responseType?: 'tuple'): Promise<ApiResponseTuple<T>>;
27
- protected handleMonitorResponseError<T>(error: ApiError, trapAxiosException: boolean): ApiResponse<ApiEnvelope<T>> | undefined;
28
- protected monitorResponse<T>(closure: () => Promise<ApiResponse<ApiEnvelope<T>>>): Promise<ApiResponse<ApiEnvelope<T>> | undefined>;
29
- protected postEndpoint<T = unknown, D = unknown>(endPoint?: string, data?: D): Promise<ApiResponseBody<T>>;
30
- protected postEndpoint<T = unknown, D = unknown>(endPoint?: string, data?: D, responseType?: 'body'): Promise<ApiResponseBody<T>>;
31
- protected postEndpoint<T = unknown, D = unknown>(endPoint?: string, data?: D, responseType?: 'tuple'): Promise<ApiResponseTuple<T>>;
32
- protected putEndpoint<T = unknown, D = unknown>(endPoint?: string, data?: D): Promise<ApiResponseBody<T>>;
33
- protected putEndpoint<T = unknown, D = unknown>(endPoint?: string, data?: D, responseType?: 'body'): Promise<ApiResponseBody<T>>;
34
- protected putEndpoint<T = unknown, D = unknown>(endPoint?: string, data?: D, responseType?: 'tuple'): Promise<ApiResponseTuple<T>>;
35
- private resolveRoot;
36
- }
37
-
38
- type ApiSimpleQuery = PayloadFindFilter;
39
- declare class ApiSimple<T = Payload, D = T, Q extends ApiSimpleQuery = ApiSimpleQuery, C extends ApiConfig = ApiConfig> extends ApiBase<C> {
40
- delete(): Promise<ApiResponseBody<T>>;
41
- delete(responseType?: 'body'): Promise<ApiResponseBody<T>>;
42
- delete(responseType?: 'tuple'): Promise<ApiResponseTuple<T>>;
43
- find(query?: Q): Promise<ApiResponseBody<T>>;
44
- find(query?: Q, responseType?: 'body'): Promise<ApiResponseBody<T>>;
45
- find(query?: Q, responseType?: 'tuple'): Promise<ApiResponseTuple<T>>;
46
- get(): Promise<ApiResponseBody<T>>;
47
- get(responseType?: 'body'): Promise<ApiResponseBody<T>>;
48
- get(responseType?: 'tuple'): Promise<ApiResponseTuple<T>>;
49
- post(data?: D): Promise<ApiResponseBody<T>>;
50
- post(data?: D, responseType?: 'body'): Promise<ApiResponseBody<T>>;
51
- post(data?: D, responseType?: 'tuple'): Promise<ApiResponseTuple<T>>;
52
- put(data?: D): Promise<ApiResponseBody<T>>;
53
- put(data?: D, responseType?: 'body'): Promise<ApiResponseBody<T>>;
54
- put(data?: D, responseType?: 'tuple'): Promise<ApiResponseTuple<T>>;
55
- }
56
-
57
- declare class ArchivistApi<C extends ApiConfig = ApiConfig> extends ApiSimple<Payload[], C> {
58
- huri(huri: Huri | string): ApiSimple<Payload, Payload, _xyo_network_payload_model.PayloadFindFilter, ApiConfig>;
59
- }
60
-
61
- interface GetLocationQueryResponse {
62
- answerHash?: string;
63
- queryHash: string;
64
- }
65
-
66
- interface LocationHeatmapPointProperties {
67
- hash: string;
68
- value: number;
69
- }
70
-
71
- declare const CurrentLocationWitnessSchema: "co.coinapp.currentlocationwitness";
72
- type CurrentLocationWitnessSchema = typeof CurrentLocationWitnessSchema;
73
- type CurrentLocationWitnessPayload = Payload<{
74
- altitudeMeters: number;
75
- directionDegrees: number;
76
- latitude: number;
77
- longitude: number;
78
- quadkey: string;
79
- schema: CurrentLocationWitnessSchema;
80
- speedKph: number;
81
- }>;
82
-
83
- declare const LocationWitnessSchema: "network.xyo.location";
84
- type LocationWitnessSchema = typeof LocationWitnessSchema;
85
- interface Coordinates {
86
- accuracy: number | null;
87
- altitude: number | null;
88
- altitudeAccuracy: number | null;
89
- heading: number | null;
90
- latitude: number;
91
- longitude: number;
92
- speed: number | null;
93
- }
94
- interface CurrentLocation {
95
- coords: Coordinates;
96
- timestamp: number;
97
- }
98
- type LocationWitnessPayload = Payload<{
99
- currentLocation: CurrentLocation;
100
- schema: LocationWitnessSchema;
101
- }>;
102
-
103
- declare const LocationHeatmapQuerySchema: "network.xyo.location.heatmap.query";
104
- type LocationHeatmapQuerySchema = typeof LocationHeatmapQuerySchema;
105
- declare const LocationHeatmapAnswerSchema: "network.xyo.location.heatmap.answer";
106
- type LocationHeatmapAnswerSchema = typeof LocationHeatmapAnswerSchema;
107
- type LocationHeatmapQuery = {
108
- schema: LocationWitnessSchema;
109
- startTime?: string;
110
- stopTime?: string;
111
- };
112
- declare const isLocationHeatmapQuery: (query: Record<string, unknown>) => query is LocationHeatmapQuery;
113
-
114
- declare const LocationQuadkeyHeatmapQuerySchema: "network.xyo.location.heatmap.quadkey.query";
115
- type LocationQuadkeyHeatmapQuerySchema = typeof LocationQuadkeyHeatmapQuerySchema;
116
- declare const LocationQuadkeyHeatmapAnswerSchema: "network.xyo.location.heatmap.quadkey.answer";
117
- type LocationQuadkeyHeatmapAnswerSchema = typeof LocationQuadkeyHeatmapAnswerSchema;
118
- type LocationQuadkeyHeatmapQuery = {
119
- schema: LocationWitnessSchema;
120
- startTime?: string;
121
- stopTime?: string;
122
- };
123
- declare const isLocationQuadkeyHeatmapQuery: (query: Record<string, unknown>) => query is LocationQuadkeyHeatmapQuery;
124
-
125
- interface LocationTimeRangePointProperties {
126
- _archive: string;
127
- _client: string;
128
- _timestamp: number;
129
- schema: LocationWitnessSchema;
130
- }
131
-
132
- declare const LocationTimeRangeQuerySchema: "network.xyo.location.range.query";
133
- type LocationTimeRangeQuerySchema = typeof LocationTimeRangeQuerySchema;
134
- declare const LocationTimeRangeAnswerSchema: "network.xyo.location.range.answer";
135
- type LocationTimeRangeAnswerSchema = typeof LocationTimeRangeAnswerSchema;
136
- type LocationTimeRangeQuery = {
137
- schema: LocationWitnessSchema;
138
- startTime?: string;
139
- stopTime?: string;
140
- };
141
- declare const isLocationTimeRangeQuery: (query: Record<string, unknown>) => query is LocationTimeRangeQuery;
142
-
143
- type LocationQuerySchema = LocationQuadkeyHeatmapQuerySchema | LocationHeatmapQuerySchema | LocationTimeRangeQuerySchema;
144
- declare const isSupportedLocationQuerySchema: (schema: string) => schema is LocationQuerySchema;
145
-
146
- interface LocationQueryCreationRequest<TSchema extends LocationQuerySchema = LocationQuerySchema, TQuery extends Record<string, unknown> = Record<string, unknown>> {
147
- query: TQuery;
148
- resultArchive: string;
149
- resultArchivist: ApiConfig;
150
- schema: TSchema;
151
- sourceArchive: string;
152
- sourceArchivist: ApiConfig;
153
- }
154
- type LocationTimeRangeQueryCreationRequest = LocationQueryCreationRequest<LocationTimeRangeQuerySchema, LocationTimeRangeQuery>;
155
- type LocationHeatmapQueryCreationRequest = LocationQueryCreationRequest<LocationHeatmapQuerySchema, LocationHeatmapQuery>;
156
- type LocationQuadkeyHeatmapQueryCreationRequest = LocationQueryCreationRequest<LocationQuadkeyHeatmapQuerySchema, LocationQuadkeyHeatmapQuery>;
157
- type SupportedLocationQueryCreationRequest = LocationTimeRangeQueryCreationRequest | LocationHeatmapQueryCreationRequest | LocationQuadkeyHeatmapQueryCreationRequest;
158
-
159
- interface LocationQueryCreationResponse extends LocationQueryCreationRequest {
160
- hash: string;
161
- }
162
-
163
- declare class LocationDivinerApi {
164
- config: ApiConfig;
165
- constructor(config: ApiConfig);
166
- private get axiosRequestConfig();
167
- getLocationQuery(hash: string): Promise<GetLocationQueryResponse>;
168
- postLocationQuery(request: SupportedLocationQueryCreationRequest): Promise<LocationQueryCreationResponse>;
169
- }
170
- //# sourceMappingURL=LocationDivinerApi.d.ts.map
171
-
172
- declare const RemoteDivinerConfigSchema: "network.xyo.diviner.remote.config";
173
- type RemoteDivinerConfigSchema = typeof RemoteDivinerConfigSchema;
174
- type RemoteDivinerConfig = DivinerConfig & {
175
- /** @deprecated use in params instead */
176
- api?: ArchivistApi;
177
- archive?: string;
178
- schema: RemoteDivinerConfigSchema;
179
- };
180
-
181
- declare class RemoteDivinerError extends Error {
182
- isRemoteDivinerError: boolean;
183
- constructor(action: string, error: Error['cause'], message?: string);
184
- static isRemoteDivinerError(error: unknown): RemoteDivinerError | undefined;
185
- }
186
-
187
- interface ArchivePath {
188
- archive: string;
189
- }
190
-
191
- declare type WithArchive<ArchivistApiConfig> = ArchivistApiConfig & {
192
- _archive?: string;
193
- };
194
-
195
- export { ApiBase, ApiSimple, ArchivistApi, CurrentLocationWitnessSchema, LocationDivinerApi, LocationHeatmapAnswerSchema, LocationHeatmapQuerySchema, LocationQuadkeyHeatmapAnswerSchema, LocationQuadkeyHeatmapQuerySchema, LocationTimeRangeAnswerSchema, LocationTimeRangeQuerySchema, LocationWitnessSchema, RemoteDivinerConfigSchema, RemoteDivinerError, isLocationHeatmapQuery, isLocationQuadkeyHeatmapQuery, isLocationTimeRangeQuery, isSupportedLocationQuerySchema };
196
- export type { ApiSimpleQuery, ArchivePath, Coordinates, CurrentLocation, CurrentLocationWitnessPayload, GetLocationQueryResponse, LocationHeatmapPointProperties, LocationHeatmapQuery, LocationHeatmapQueryCreationRequest, LocationQuadkeyHeatmapQuery, LocationQuadkeyHeatmapQueryCreationRequest, LocationQueryCreationRequest, LocationQueryCreationResponse, LocationQuerySchema, LocationTimeRangePointProperties, LocationTimeRangeQuery, LocationTimeRangeQueryCreationRequest, LocationWitnessPayload, RemoteDivinerConfig, SupportedLocationQueryCreationRequest, WithArchive };
1
+ export * from './Api/index.ts';
2
+ export * from './Base.ts';
3
+ export * from './Diviner/index.ts';
4
+ export * from './models/index.ts';
5
+ export * from './Simple.ts';
6
+ export * from './WithArchive.ts';
7
+ //# sourceMappingURL=index.d.ts.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xyo-network/api",
3
- "version": "4.1.1",
3
+ "version": "4.1.3",
4
4
  "description": "Primary SDK for using XYO Protocol 2.0",
5
5
  "homepage": "https://xyo.network",
6
6
  "bugs": {
@@ -29,24 +29,24 @@
29
29
  "module": "dist/neutral/index.mjs",
30
30
  "types": "dist/neutral/index.d.ts",
31
31
  "dependencies": {
32
- "@xylabs/axios": "^4.13.15",
33
- "@xylabs/typeof": "^4.13.15",
34
- "@xyo-network/api-models": "^4.1.1",
35
- "@xyo-network/diviner-model": "^4.1.1",
36
- "@xyo-network/huri": "^4.1.1",
37
- "@xyo-network/payload-model": "^4.1.1",
32
+ "@xylabs/axios": "^4.13.16",
33
+ "@xylabs/typeof": "^4.13.16",
34
+ "@xyo-network/api-models": "^4.1.3",
35
+ "@xyo-network/diviner-model": "^4.1.3",
36
+ "@xyo-network/huri": "^4.1.3",
37
+ "@xyo-network/payload-model": "^4.1.3",
38
38
  "axios": "^1.10.0"
39
39
  },
40
40
  "devDependencies": {
41
- "@types/node": "^24.0.13",
41
+ "@types/node": "^24.0.14",
42
42
  "@types/uuid": "^10.0.0",
43
- "@xylabs/object": "^4.13.15",
44
- "@xylabs/ts-scripts-yarn3": "^7.0.0-rc.23",
45
- "@xylabs/tsconfig": "^7.0.0-rc.23",
46
- "@xylabs/vitest-extended": "^4.13.15",
47
- "@xyo-network/boundwitness-model": "^4.1.1",
48
- "@xyo-network/module-model": "^4.1.1",
49
- "@xyo-network/query-payload-plugin": "^4.1.1",
43
+ "@xylabs/object": "^4.13.16",
44
+ "@xylabs/ts-scripts-yarn3": "^7.0.0-rc.27",
45
+ "@xylabs/tsconfig": "^7.0.0-rc.27",
46
+ "@xylabs/vitest-extended": "^4.13.16",
47
+ "@xyo-network/boundwitness-model": "^4.1.3",
48
+ "@xyo-network/module-model": "^4.1.3",
49
+ "@xyo-network/query-payload-plugin": "^4.1.3",
50
50
  "typescript": "^5.8.3",
51
51
  "uuid": "^11.1.0",
52
52
  "vitest": "^3.2.4"