@wix/atlas 1.0.16 → 1.0.18
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/build/cjs/context.js +1 -0
- package/build/cjs/context.js.map +1 -0
- package/build/cjs/index.d.ts +4 -3
- package/build/cjs/index.js +7 -3
- package/build/cjs/index.js.map +1 -0
- package/build/cjs/meta.js +1 -0
- package/build/cjs/meta.js.map +1 -0
- package/build/es/index.d.ts +4 -3
- package/build/es/index.js +4 -3
- package/build/es/index.js.map +1 -1
- package/package.json +8 -8
- package/type-bundles/context.bundle.d.ts +703 -107
- package/type-bundles/index.bundle.d.ts +546 -102
- package/type-bundles/meta.bundle.d.ts +98 -70
|
@@ -1,3 +1,481 @@
|
|
|
1
|
+
type HostModule<T, H extends Host> = {
|
|
2
|
+
__type: 'host';
|
|
3
|
+
create(host: H): T;
|
|
4
|
+
};
|
|
5
|
+
type HostModuleAPI<T extends HostModule<any, any>> = T extends HostModule<infer U, any> ? U : never;
|
|
6
|
+
type Host<Environment = unknown> = {
|
|
7
|
+
channel: {
|
|
8
|
+
observeState(callback: (props: unknown, environment: Environment) => unknown): {
|
|
9
|
+
disconnect: () => void;
|
|
10
|
+
} | Promise<{
|
|
11
|
+
disconnect: () => void;
|
|
12
|
+
}>;
|
|
13
|
+
};
|
|
14
|
+
environment?: Environment;
|
|
15
|
+
/**
|
|
16
|
+
* Optional name of the environment, use for logging
|
|
17
|
+
*/
|
|
18
|
+
name?: string;
|
|
19
|
+
/**
|
|
20
|
+
* Optional bast url to use for API requests, for example `www.wixapis.com`
|
|
21
|
+
*/
|
|
22
|
+
apiBaseUrl?: string;
|
|
23
|
+
/**
|
|
24
|
+
* Possible data to be provided by every host, for cross cutting concerns
|
|
25
|
+
* like internationalization, billing, etc.
|
|
26
|
+
*/
|
|
27
|
+
essentials?: {
|
|
28
|
+
/**
|
|
29
|
+
* The language of the currently viewed session
|
|
30
|
+
*/
|
|
31
|
+
language?: string;
|
|
32
|
+
/**
|
|
33
|
+
* The locale of the currently viewed session
|
|
34
|
+
*/
|
|
35
|
+
locale?: string;
|
|
36
|
+
/**
|
|
37
|
+
* Any headers that should be passed through to the API requests
|
|
38
|
+
*/
|
|
39
|
+
passThroughHeaders?: Record<string, string>;
|
|
40
|
+
};
|
|
41
|
+
};
|
|
42
|
+
|
|
43
|
+
type RESTFunctionDescriptor<T extends (...args: any[]) => any = (...args: any[]) => any> = (httpClient: HttpClient) => T;
|
|
44
|
+
interface HttpClient {
|
|
45
|
+
request<TResponse, TData = any>(req: RequestOptionsFactory<TResponse, TData>): Promise<HttpResponse<TResponse>>;
|
|
46
|
+
fetchWithAuth: typeof fetch;
|
|
47
|
+
wixAPIFetch: (relativeUrl: string, options: RequestInit) => Promise<Response>;
|
|
48
|
+
getActiveToken?: () => string | undefined;
|
|
49
|
+
}
|
|
50
|
+
type RequestOptionsFactory<TResponse = any, TData = any> = (context: any) => RequestOptions<TResponse, TData>;
|
|
51
|
+
type HttpResponse<T = any> = {
|
|
52
|
+
data: T;
|
|
53
|
+
status: number;
|
|
54
|
+
statusText: string;
|
|
55
|
+
headers: any;
|
|
56
|
+
request?: any;
|
|
57
|
+
};
|
|
58
|
+
type RequestOptions<_TResponse = any, Data = any> = {
|
|
59
|
+
method: 'POST' | 'GET' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
|
|
60
|
+
url: string;
|
|
61
|
+
data?: Data;
|
|
62
|
+
params?: URLSearchParams;
|
|
63
|
+
} & APIMetadata;
|
|
64
|
+
type APIMetadata = {
|
|
65
|
+
methodFqn?: string;
|
|
66
|
+
entityFqdn?: string;
|
|
67
|
+
packageName?: string;
|
|
68
|
+
};
|
|
69
|
+
type BuildRESTFunction<T extends RESTFunctionDescriptor> = T extends RESTFunctionDescriptor<infer U> ? U : never;
|
|
70
|
+
type EventDefinition<Payload = unknown, Type extends string = string> = {
|
|
71
|
+
__type: 'event-definition';
|
|
72
|
+
type: Type;
|
|
73
|
+
isDomainEvent?: boolean;
|
|
74
|
+
transformations?: (envelope: unknown) => Payload;
|
|
75
|
+
__payload: Payload;
|
|
76
|
+
};
|
|
77
|
+
declare function EventDefinition<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition<Payload, Type>;
|
|
78
|
+
type EventHandler<T extends EventDefinition> = (payload: T['__payload']) => void | Promise<void>;
|
|
79
|
+
type BuildEventDefinition<T extends EventDefinition<any, string>> = (handler: EventHandler<T>) => void;
|
|
80
|
+
|
|
81
|
+
type ServicePluginMethodInput = {
|
|
82
|
+
request: any;
|
|
83
|
+
metadata: any;
|
|
84
|
+
};
|
|
85
|
+
type ServicePluginContract = Record<string, (payload: ServicePluginMethodInput) => unknown | Promise<unknown>>;
|
|
86
|
+
type ServicePluginMethodMetadata = {
|
|
87
|
+
name: string;
|
|
88
|
+
primaryHttpMappingPath: string;
|
|
89
|
+
transformations: {
|
|
90
|
+
fromREST: (...args: unknown[]) => ServicePluginMethodInput;
|
|
91
|
+
toREST: (...args: unknown[]) => unknown;
|
|
92
|
+
};
|
|
93
|
+
};
|
|
94
|
+
type ServicePluginDefinition<Contract extends ServicePluginContract> = {
|
|
95
|
+
__type: 'service-plugin-definition';
|
|
96
|
+
componentType: string;
|
|
97
|
+
methods: ServicePluginMethodMetadata[];
|
|
98
|
+
__contract: Contract;
|
|
99
|
+
};
|
|
100
|
+
declare function ServicePluginDefinition<Contract extends ServicePluginContract>(componentType: string, methods: ServicePluginMethodMetadata[]): ServicePluginDefinition<Contract>;
|
|
101
|
+
type BuildServicePluginDefinition<T extends ServicePluginDefinition<any>> = (implementation: T['__contract']) => void;
|
|
102
|
+
declare const SERVICE_PLUGIN_ERROR_TYPE = "wix_spi_error";
|
|
103
|
+
|
|
104
|
+
type RequestContext = {
|
|
105
|
+
isSSR: boolean;
|
|
106
|
+
host: string;
|
|
107
|
+
protocol?: string;
|
|
108
|
+
};
|
|
109
|
+
type ResponseTransformer = (data: any, headers?: any) => any;
|
|
110
|
+
/**
|
|
111
|
+
* Ambassador request options types are copied mostly from AxiosRequestConfig.
|
|
112
|
+
* They are copied and not imported to reduce the amount of dependencies (to reduce install time).
|
|
113
|
+
* https://github.com/axios/axios/blob/3f53eb6960f05a1f88409c4b731a40de595cb825/index.d.ts#L307-L315
|
|
114
|
+
*/
|
|
115
|
+
type Method = 'get' | 'GET' | 'delete' | 'DELETE' | 'head' | 'HEAD' | 'options' | 'OPTIONS' | 'post' | 'POST' | 'put' | 'PUT' | 'patch' | 'PATCH' | 'purge' | 'PURGE' | 'link' | 'LINK' | 'unlink' | 'UNLINK';
|
|
116
|
+
type AmbassadorRequestOptions<T = any> = {
|
|
117
|
+
_?: T;
|
|
118
|
+
url?: string;
|
|
119
|
+
method?: Method;
|
|
120
|
+
params?: any;
|
|
121
|
+
data?: any;
|
|
122
|
+
transformResponse?: ResponseTransformer | ResponseTransformer[];
|
|
123
|
+
};
|
|
124
|
+
type AmbassadorFactory<Request, Response> = (payload: Request) => ((context: RequestContext) => AmbassadorRequestOptions<Response>) & {
|
|
125
|
+
__isAmbassador: boolean;
|
|
126
|
+
};
|
|
127
|
+
type AmbassadorFunctionDescriptor<Request = any, Response = any> = AmbassadorFactory<Request, Response>;
|
|
128
|
+
type BuildAmbassadorFunction<T extends AmbassadorFunctionDescriptor> = T extends AmbassadorFunctionDescriptor<infer Request, infer Response> ? (req: Request) => Promise<Response> : never;
|
|
129
|
+
|
|
130
|
+
declare global {
|
|
131
|
+
// eslint-disable-next-line @typescript-eslint/consistent-type-definitions -- It has to be an `interface` so that it can be merged.
|
|
132
|
+
interface SymbolConstructor {
|
|
133
|
+
readonly observable: symbol;
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
declare const emptyObjectSymbol: unique symbol;
|
|
138
|
+
|
|
139
|
+
/**
|
|
140
|
+
Represents a strictly empty plain object, the `{}` value.
|
|
141
|
+
|
|
142
|
+
When you annotate something as the type `{}`, it can be anything except `null` and `undefined`. This means that you cannot use `{}` to represent an empty plain object ([read more](https://stackoverflow.com/questions/47339869/typescript-empty-object-and-any-difference/52193484#52193484)).
|
|
143
|
+
|
|
144
|
+
@example
|
|
145
|
+
```
|
|
146
|
+
import type {EmptyObject} from 'type-fest';
|
|
147
|
+
|
|
148
|
+
// The following illustrates the problem with `{}`.
|
|
149
|
+
const foo1: {} = {}; // Pass
|
|
150
|
+
const foo2: {} = []; // Pass
|
|
151
|
+
const foo3: {} = 42; // Pass
|
|
152
|
+
const foo4: {} = {a: 1}; // Pass
|
|
153
|
+
|
|
154
|
+
// With `EmptyObject` only the first case is valid.
|
|
155
|
+
const bar1: EmptyObject = {}; // Pass
|
|
156
|
+
const bar2: EmptyObject = 42; // Fail
|
|
157
|
+
const bar3: EmptyObject = []; // Fail
|
|
158
|
+
const bar4: EmptyObject = {a: 1}; // Fail
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
Unfortunately, `Record<string, never>`, `Record<keyof any, never>` and `Record<never, never>` do not work. See {@link https://github.com/sindresorhus/type-fest/issues/395 #395}.
|
|
162
|
+
|
|
163
|
+
@category Object
|
|
164
|
+
*/
|
|
165
|
+
type EmptyObject = {[emptyObjectSymbol]?: never};
|
|
166
|
+
|
|
167
|
+
/**
|
|
168
|
+
Returns a boolean for whether the two given types are equal.
|
|
169
|
+
|
|
170
|
+
@link https://github.com/microsoft/TypeScript/issues/27024#issuecomment-421529650
|
|
171
|
+
@link https://stackoverflow.com/questions/68961864/how-does-the-equals-work-in-typescript/68963796#68963796
|
|
172
|
+
|
|
173
|
+
Use-cases:
|
|
174
|
+
- If you want to make a conditional branch based on the result of a comparison of two types.
|
|
175
|
+
|
|
176
|
+
@example
|
|
177
|
+
```
|
|
178
|
+
import type {IsEqual} from 'type-fest';
|
|
179
|
+
|
|
180
|
+
// This type returns a boolean for whether the given array includes the given item.
|
|
181
|
+
// `IsEqual` is used to compare the given array at position 0 and the given item and then return true if they are equal.
|
|
182
|
+
type Includes<Value extends readonly any[], Item> =
|
|
183
|
+
Value extends readonly [Value[0], ...infer rest]
|
|
184
|
+
? IsEqual<Value[0], Item> extends true
|
|
185
|
+
? true
|
|
186
|
+
: Includes<rest, Item>
|
|
187
|
+
: false;
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
@category Type Guard
|
|
191
|
+
@category Utilities
|
|
192
|
+
*/
|
|
193
|
+
type IsEqual<A, B> =
|
|
194
|
+
(<G>() => G extends A ? 1 : 2) extends
|
|
195
|
+
(<G>() => G extends B ? 1 : 2)
|
|
196
|
+
? true
|
|
197
|
+
: false;
|
|
198
|
+
|
|
199
|
+
/**
|
|
200
|
+
Filter out keys from an object.
|
|
201
|
+
|
|
202
|
+
Returns `never` if `Exclude` is strictly equal to `Key`.
|
|
203
|
+
Returns `never` if `Key` extends `Exclude`.
|
|
204
|
+
Returns `Key` otherwise.
|
|
205
|
+
|
|
206
|
+
@example
|
|
207
|
+
```
|
|
208
|
+
type Filtered = Filter<'foo', 'foo'>;
|
|
209
|
+
//=> never
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
@example
|
|
213
|
+
```
|
|
214
|
+
type Filtered = Filter<'bar', string>;
|
|
215
|
+
//=> never
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
@example
|
|
219
|
+
```
|
|
220
|
+
type Filtered = Filter<'bar', 'foo'>;
|
|
221
|
+
//=> 'bar'
|
|
222
|
+
```
|
|
223
|
+
|
|
224
|
+
@see {Except}
|
|
225
|
+
*/
|
|
226
|
+
type Filter<KeyType, ExcludeType> = IsEqual<KeyType, ExcludeType> extends true ? never : (KeyType extends ExcludeType ? never : KeyType);
|
|
227
|
+
|
|
228
|
+
type ExceptOptions = {
|
|
229
|
+
/**
|
|
230
|
+
Disallow assigning non-specified properties.
|
|
231
|
+
|
|
232
|
+
Note that any omitted properties in the resulting type will be present in autocomplete as `undefined`.
|
|
233
|
+
|
|
234
|
+
@default false
|
|
235
|
+
*/
|
|
236
|
+
requireExactProps?: boolean;
|
|
237
|
+
};
|
|
238
|
+
|
|
239
|
+
/**
|
|
240
|
+
Create a type from an object type without certain keys.
|
|
241
|
+
|
|
242
|
+
We recommend setting the `requireExactProps` option to `true`.
|
|
243
|
+
|
|
244
|
+
This type is a stricter version of [`Omit`](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-3-5.html#the-omit-helper-type). The `Omit` type does not restrict the omitted keys to be keys present on the given type, while `Except` does. The benefits of a stricter type are avoiding typos and allowing the compiler to pick up on rename refactors automatically.
|
|
245
|
+
|
|
246
|
+
This type was proposed to the TypeScript team, which declined it, saying they prefer that libraries implement stricter versions of the built-in types ([microsoft/TypeScript#30825](https://github.com/microsoft/TypeScript/issues/30825#issuecomment-523668235)).
|
|
247
|
+
|
|
248
|
+
@example
|
|
249
|
+
```
|
|
250
|
+
import type {Except} from 'type-fest';
|
|
251
|
+
|
|
252
|
+
type Foo = {
|
|
253
|
+
a: number;
|
|
254
|
+
b: string;
|
|
255
|
+
};
|
|
256
|
+
|
|
257
|
+
type FooWithoutA = Except<Foo, 'a'>;
|
|
258
|
+
//=> {b: string}
|
|
259
|
+
|
|
260
|
+
const fooWithoutA: FooWithoutA = {a: 1, b: '2'};
|
|
261
|
+
//=> errors: 'a' does not exist in type '{ b: string; }'
|
|
262
|
+
|
|
263
|
+
type FooWithoutB = Except<Foo, 'b', {requireExactProps: true}>;
|
|
264
|
+
//=> {a: number} & Partial<Record<"b", never>>
|
|
265
|
+
|
|
266
|
+
const fooWithoutB: FooWithoutB = {a: 1, b: '2'};
|
|
267
|
+
//=> errors at 'b': Type 'string' is not assignable to type 'undefined'.
|
|
268
|
+
```
|
|
269
|
+
|
|
270
|
+
@category Object
|
|
271
|
+
*/
|
|
272
|
+
type Except<ObjectType, KeysType extends keyof ObjectType, Options extends ExceptOptions = {requireExactProps: false}> = {
|
|
273
|
+
[KeyType in keyof ObjectType as Filter<KeyType, KeysType>]: ObjectType[KeyType];
|
|
274
|
+
} & (Options['requireExactProps'] extends true
|
|
275
|
+
? Partial<Record<KeysType, never>>
|
|
276
|
+
: {});
|
|
277
|
+
|
|
278
|
+
/**
|
|
279
|
+
Returns a boolean for whether the given type is `never`.
|
|
280
|
+
|
|
281
|
+
@link https://github.com/microsoft/TypeScript/issues/31751#issuecomment-498526919
|
|
282
|
+
@link https://stackoverflow.com/a/53984913/10292952
|
|
283
|
+
@link https://www.zhenghao.io/posts/ts-never
|
|
284
|
+
|
|
285
|
+
Useful in type utilities, such as checking if something does not occur.
|
|
286
|
+
|
|
287
|
+
@example
|
|
288
|
+
```
|
|
289
|
+
import type {IsNever, And} from 'type-fest';
|
|
290
|
+
|
|
291
|
+
// https://github.com/andnp/SimplyTyped/blob/master/src/types/strings.ts
|
|
292
|
+
type AreStringsEqual<A extends string, B extends string> =
|
|
293
|
+
And<
|
|
294
|
+
IsNever<Exclude<A, B>> extends true ? true : false,
|
|
295
|
+
IsNever<Exclude<B, A>> extends true ? true : false
|
|
296
|
+
>;
|
|
297
|
+
|
|
298
|
+
type EndIfEqual<I extends string, O extends string> =
|
|
299
|
+
AreStringsEqual<I, O> extends true
|
|
300
|
+
? never
|
|
301
|
+
: void;
|
|
302
|
+
|
|
303
|
+
function endIfEqual<I extends string, O extends string>(input: I, output: O): EndIfEqual<I, O> {
|
|
304
|
+
if (input === output) {
|
|
305
|
+
process.exit(0);
|
|
306
|
+
}
|
|
307
|
+
}
|
|
308
|
+
|
|
309
|
+
endIfEqual('abc', 'abc');
|
|
310
|
+
//=> never
|
|
311
|
+
|
|
312
|
+
endIfEqual('abc', '123');
|
|
313
|
+
//=> void
|
|
314
|
+
```
|
|
315
|
+
|
|
316
|
+
@category Type Guard
|
|
317
|
+
@category Utilities
|
|
318
|
+
*/
|
|
319
|
+
type IsNever<T> = [T] extends [never] ? true : false;
|
|
320
|
+
|
|
321
|
+
/**
|
|
322
|
+
An if-else-like type that resolves depending on whether the given type is `never`.
|
|
323
|
+
|
|
324
|
+
@see {@link IsNever}
|
|
325
|
+
|
|
326
|
+
@example
|
|
327
|
+
```
|
|
328
|
+
import type {IfNever} from 'type-fest';
|
|
329
|
+
|
|
330
|
+
type ShouldBeTrue = IfNever<never>;
|
|
331
|
+
//=> true
|
|
332
|
+
|
|
333
|
+
type ShouldBeBar = IfNever<'not never', 'foo', 'bar'>;
|
|
334
|
+
//=> 'bar'
|
|
335
|
+
```
|
|
336
|
+
|
|
337
|
+
@category Type Guard
|
|
338
|
+
@category Utilities
|
|
339
|
+
*/
|
|
340
|
+
type IfNever<T, TypeIfNever = true, TypeIfNotNever = false> = (
|
|
341
|
+
IsNever<T> extends true ? TypeIfNever : TypeIfNotNever
|
|
342
|
+
);
|
|
343
|
+
|
|
344
|
+
/**
|
|
345
|
+
Extract the keys from a type where the value type of the key extends the given `Condition`.
|
|
346
|
+
|
|
347
|
+
Internally this is used for the `ConditionalPick` and `ConditionalExcept` types.
|
|
348
|
+
|
|
349
|
+
@example
|
|
350
|
+
```
|
|
351
|
+
import type {ConditionalKeys} from 'type-fest';
|
|
352
|
+
|
|
353
|
+
interface Example {
|
|
354
|
+
a: string;
|
|
355
|
+
b: string | number;
|
|
356
|
+
c?: string;
|
|
357
|
+
d: {};
|
|
358
|
+
}
|
|
359
|
+
|
|
360
|
+
type StringKeysOnly = ConditionalKeys<Example, string>;
|
|
361
|
+
//=> 'a'
|
|
362
|
+
```
|
|
363
|
+
|
|
364
|
+
To support partial types, make sure your `Condition` is a union of undefined (for example, `string | undefined`) as demonstrated below.
|
|
365
|
+
|
|
366
|
+
@example
|
|
367
|
+
```
|
|
368
|
+
import type {ConditionalKeys} from 'type-fest';
|
|
369
|
+
|
|
370
|
+
type StringKeysAndUndefined = ConditionalKeys<Example, string | undefined>;
|
|
371
|
+
//=> 'a' | 'c'
|
|
372
|
+
```
|
|
373
|
+
|
|
374
|
+
@category Object
|
|
375
|
+
*/
|
|
376
|
+
type ConditionalKeys<Base, Condition> =
|
|
377
|
+
{
|
|
378
|
+
// Map through all the keys of the given base type.
|
|
379
|
+
[Key in keyof Base]-?:
|
|
380
|
+
// Pick only keys with types extending the given `Condition` type.
|
|
381
|
+
Base[Key] extends Condition
|
|
382
|
+
// Retain this key
|
|
383
|
+
// If the value for the key extends never, only include it if `Condition` also extends never
|
|
384
|
+
? IfNever<Base[Key], IfNever<Condition, Key, never>, Key>
|
|
385
|
+
// Discard this key since the condition fails.
|
|
386
|
+
: never;
|
|
387
|
+
// Convert the produced object into a union type of the keys which passed the conditional test.
|
|
388
|
+
}[keyof Base];
|
|
389
|
+
|
|
390
|
+
/**
|
|
391
|
+
Exclude keys from a shape that matches the given `Condition`.
|
|
392
|
+
|
|
393
|
+
This is useful when you want to create a new type with a specific set of keys from a shape. For example, you might want to exclude all the primitive properties from a class and form a new shape containing everything but the primitive properties.
|
|
394
|
+
|
|
395
|
+
@example
|
|
396
|
+
```
|
|
397
|
+
import type {Primitive, ConditionalExcept} from 'type-fest';
|
|
398
|
+
|
|
399
|
+
class Awesome {
|
|
400
|
+
name: string;
|
|
401
|
+
successes: number;
|
|
402
|
+
failures: bigint;
|
|
403
|
+
|
|
404
|
+
run() {}
|
|
405
|
+
}
|
|
406
|
+
|
|
407
|
+
type ExceptPrimitivesFromAwesome = ConditionalExcept<Awesome, Primitive>;
|
|
408
|
+
//=> {run: () => void}
|
|
409
|
+
```
|
|
410
|
+
|
|
411
|
+
@example
|
|
412
|
+
```
|
|
413
|
+
import type {ConditionalExcept} from 'type-fest';
|
|
414
|
+
|
|
415
|
+
interface Example {
|
|
416
|
+
a: string;
|
|
417
|
+
b: string | number;
|
|
418
|
+
c: () => void;
|
|
419
|
+
d: {};
|
|
420
|
+
}
|
|
421
|
+
|
|
422
|
+
type NonStringKeysOnly = ConditionalExcept<Example, string>;
|
|
423
|
+
//=> {b: string | number; c: () => void; d: {}}
|
|
424
|
+
```
|
|
425
|
+
|
|
426
|
+
@category Object
|
|
427
|
+
*/
|
|
428
|
+
type ConditionalExcept<Base, Condition> = Except<
|
|
429
|
+
Base,
|
|
430
|
+
ConditionalKeys<Base, Condition>
|
|
431
|
+
>;
|
|
432
|
+
|
|
433
|
+
/**
|
|
434
|
+
* Descriptors are objects that describe the API of a module, and the module
|
|
435
|
+
* can either be a REST module or a host module.
|
|
436
|
+
* This type is recursive, so it can describe nested modules.
|
|
437
|
+
*/
|
|
438
|
+
type Descriptors = RESTFunctionDescriptor | AmbassadorFunctionDescriptor | HostModule<any, any> | EventDefinition<any> | ServicePluginDefinition<any> | {
|
|
439
|
+
[key: string]: Descriptors | PublicMetadata | any;
|
|
440
|
+
};
|
|
441
|
+
/**
|
|
442
|
+
* This type takes in a descriptors object of a certain Host (including an `unknown` host)
|
|
443
|
+
* and returns an object with the same structure, but with all descriptors replaced with their API.
|
|
444
|
+
* Any non-descriptor properties are removed from the returned object, including descriptors that
|
|
445
|
+
* do not match the given host (as they will not work with the given host).
|
|
446
|
+
*/
|
|
447
|
+
type BuildDescriptors<T extends Descriptors, H extends Host<any> | undefined, Depth extends number = 5> = {
|
|
448
|
+
done: T;
|
|
449
|
+
recurse: T extends {
|
|
450
|
+
__type: typeof SERVICE_PLUGIN_ERROR_TYPE;
|
|
451
|
+
} ? never : T extends AmbassadorFunctionDescriptor ? BuildAmbassadorFunction<T> : T extends RESTFunctionDescriptor ? BuildRESTFunction<T> : T extends EventDefinition<any> ? BuildEventDefinition<T> : T extends ServicePluginDefinition<any> ? BuildServicePluginDefinition<T> : T extends HostModule<any, any> ? HostModuleAPI<T> : ConditionalExcept<{
|
|
452
|
+
[Key in keyof T]: T[Key] extends Descriptors ? BuildDescriptors<T[Key], H, [
|
|
453
|
+
-1,
|
|
454
|
+
0,
|
|
455
|
+
1,
|
|
456
|
+
2,
|
|
457
|
+
3,
|
|
458
|
+
4,
|
|
459
|
+
5
|
|
460
|
+
][Depth]> : never;
|
|
461
|
+
}, EmptyObject>;
|
|
462
|
+
}[Depth extends -1 ? 'done' : 'recurse'];
|
|
463
|
+
type PublicMetadata = {
|
|
464
|
+
PACKAGE_NAME?: string;
|
|
465
|
+
};
|
|
466
|
+
|
|
467
|
+
declare global {
|
|
468
|
+
interface ContextualClient {
|
|
469
|
+
}
|
|
470
|
+
}
|
|
471
|
+
/**
|
|
472
|
+
* A type used to create concerete types from SDK descriptors in
|
|
473
|
+
* case a contextual client is available.
|
|
474
|
+
*/
|
|
475
|
+
type MaybeContext<T extends Descriptors> = globalThis.ContextualClient extends {
|
|
476
|
+
host: Host;
|
|
477
|
+
} ? BuildDescriptors<T, globalThis.ContextualClient['host']> : T;
|
|
478
|
+
|
|
1
479
|
interface Place {
|
|
2
480
|
/** The given place id */
|
|
3
481
|
placeId?: string;
|
|
@@ -71,44 +549,36 @@ interface GetPlaceRequest {
|
|
|
71
549
|
interface GetPlaceResponse {
|
|
72
550
|
place?: Place;
|
|
73
551
|
}
|
|
552
|
+
interface StreetAddressNonNullableFields$1 {
|
|
553
|
+
number: string;
|
|
554
|
+
name: string;
|
|
555
|
+
apt: string;
|
|
556
|
+
}
|
|
557
|
+
interface AddressNonNullableFields$1 {
|
|
558
|
+
streetAddress?: StreetAddressNonNullableFields$1;
|
|
559
|
+
}
|
|
560
|
+
interface PlaceNonNullableFields {
|
|
561
|
+
placeId: string;
|
|
562
|
+
address?: AddressNonNullableFields$1;
|
|
563
|
+
types: string[];
|
|
564
|
+
}
|
|
74
565
|
interface GetPlaceResponseNonNullableFields {
|
|
75
|
-
place?:
|
|
76
|
-
placeId: string;
|
|
77
|
-
types: string[];
|
|
78
|
-
};
|
|
566
|
+
place?: PlaceNonNullableFields;
|
|
79
567
|
}
|
|
80
568
|
interface GetPlaceOptions {
|
|
81
569
|
/** A random string which identifies an autocomplete session for billing purposes. The session begins when the user starts typing a query, and concludes when they select a place and a call to Get Place is made. Once a session has concluded, the token is no longer valid. your app must generate a fresh token for each session. */
|
|
82
570
|
sessionToken?: string | null;
|
|
83
571
|
}
|
|
84
572
|
|
|
85
|
-
|
|
86
|
-
|
|
573
|
+
declare function getPlace$1(httpClient: HttpClient): GetPlaceSignature;
|
|
574
|
+
interface GetPlaceSignature {
|
|
575
|
+
/**
|
|
576
|
+
* Once you have a search_id from a autocomplete Search, you can request more details about a particular establishment or point of interest by initiating a get place request.
|
|
577
|
+
*/
|
|
578
|
+
(searchId: string, options?: GetPlaceOptions | undefined): Promise<GetPlaceResponse & GetPlaceResponseNonNullableFields>;
|
|
87
579
|
}
|
|
88
|
-
type RequestOptionsFactory$2<TResponse = any, TData = any> = (context: any) => RequestOptions$2<TResponse, TData>;
|
|
89
|
-
type HttpResponse$2<T = any> = {
|
|
90
|
-
data: T;
|
|
91
|
-
status: number;
|
|
92
|
-
statusText: string;
|
|
93
|
-
headers: any;
|
|
94
|
-
request?: any;
|
|
95
|
-
};
|
|
96
|
-
type RequestOptions$2<_TResponse = any, Data = any> = {
|
|
97
|
-
method: 'POST' | 'GET' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
|
|
98
|
-
url: string;
|
|
99
|
-
data?: Data;
|
|
100
|
-
params?: URLSearchParams;
|
|
101
|
-
} & APIMetadata$2;
|
|
102
|
-
type APIMetadata$2 = {
|
|
103
|
-
methodFqn?: string;
|
|
104
|
-
entityFqdn?: string;
|
|
105
|
-
packageName?: string;
|
|
106
|
-
};
|
|
107
580
|
|
|
108
|
-
declare const
|
|
109
|
-
PACKAGE_NAME: string;
|
|
110
|
-
};
|
|
111
|
-
declare function getPlace(httpClient: HttpClient$2): (searchId: string, options?: GetPlaceOptions) => Promise<GetPlaceResponse & GetPlaceResponseNonNullableFields>;
|
|
581
|
+
declare const getPlace: MaybeContext<BuildRESTFunction<typeof getPlace$1> & typeof getPlace$1>;
|
|
112
582
|
|
|
113
583
|
type index_d$2_GetPlaceOptions = GetPlaceOptions;
|
|
114
584
|
type index_d$2_GetPlaceRequest = GetPlaceRequest;
|
|
@@ -117,7 +587,7 @@ type index_d$2_GetPlaceResponseNonNullableFields = GetPlaceResponseNonNullableFi
|
|
|
117
587
|
type index_d$2_Place = Place;
|
|
118
588
|
declare const index_d$2_getPlace: typeof getPlace;
|
|
119
589
|
declare namespace index_d$2 {
|
|
120
|
-
export { type Address$1 as Address, type AddressLocation$2 as AddressLocation, type AddressStreetOneOf$1 as AddressStreetOneOf, type index_d$2_GetPlaceOptions as GetPlaceOptions, type index_d$2_GetPlaceRequest as GetPlaceRequest, type index_d$2_GetPlaceResponse as GetPlaceResponse, type index_d$2_GetPlaceResponseNonNullableFields as GetPlaceResponseNonNullableFields, type index_d$2_Place as Place, type StreetAddress$1 as StreetAddress, type Subdivision$1 as Subdivision, SubdivisionType$1 as SubdivisionType,
|
|
590
|
+
export { type Address$1 as Address, type AddressLocation$2 as AddressLocation, type AddressStreetOneOf$1 as AddressStreetOneOf, type index_d$2_GetPlaceOptions as GetPlaceOptions, type index_d$2_GetPlaceRequest as GetPlaceRequest, type index_d$2_GetPlaceResponse as GetPlaceResponse, type index_d$2_GetPlaceResponseNonNullableFields as GetPlaceResponseNonNullableFields, type index_d$2_Place as Place, type StreetAddress$1 as StreetAddress, type Subdivision$1 as Subdivision, SubdivisionType$1 as SubdivisionType, index_d$2_getPlace as getPlace };
|
|
121
591
|
}
|
|
122
592
|
|
|
123
593
|
interface Prediction {
|
|
@@ -194,23 +664,23 @@ interface PredictRequest {
|
|
|
194
664
|
interface PredictResponse {
|
|
195
665
|
predictions?: Prediction[];
|
|
196
666
|
}
|
|
667
|
+
interface MatchedSubstringsNonNullableFields {
|
|
668
|
+
length: number;
|
|
669
|
+
offset: number;
|
|
670
|
+
}
|
|
671
|
+
interface TextStructureNonNullableFields {
|
|
672
|
+
mainText: string;
|
|
673
|
+
secondaryText: string;
|
|
674
|
+
mainTextMatchedSubstrings: MatchedSubstringsNonNullableFields[];
|
|
675
|
+
}
|
|
676
|
+
interface PredictionNonNullableFields {
|
|
677
|
+
description: string;
|
|
678
|
+
searchId: string;
|
|
679
|
+
matchedSubstrings: MatchedSubstringsNonNullableFields[];
|
|
680
|
+
textStructure?: TextStructureNonNullableFields;
|
|
681
|
+
}
|
|
197
682
|
interface PredictResponseNonNullableFields {
|
|
198
|
-
predictions:
|
|
199
|
-
description: string;
|
|
200
|
-
searchId: string;
|
|
201
|
-
matchedSubstrings: {
|
|
202
|
-
length: number;
|
|
203
|
-
offset: number;
|
|
204
|
-
}[];
|
|
205
|
-
textStructure?: {
|
|
206
|
-
mainText: string;
|
|
207
|
-
secondaryText: string;
|
|
208
|
-
mainTextMatchedSubstrings: {
|
|
209
|
-
length: number;
|
|
210
|
-
offset: number;
|
|
211
|
-
}[];
|
|
212
|
-
};
|
|
213
|
-
}[];
|
|
683
|
+
predictions: PredictionNonNullableFields[];
|
|
214
684
|
}
|
|
215
685
|
interface PredictOptions {
|
|
216
686
|
/** The origin point from which to calculate straight-line distance to the destination */
|
|
@@ -225,33 +695,16 @@ interface PredictOptions {
|
|
|
225
695
|
sessionToken?: string | null;
|
|
226
696
|
}
|
|
227
697
|
|
|
228
|
-
|
|
229
|
-
|
|
698
|
+
declare function predict$1(httpClient: HttpClient): PredictSignature;
|
|
699
|
+
interface PredictSignature {
|
|
700
|
+
/**
|
|
701
|
+
* A Predict end-point take an input and returns an list of Prediction object.
|
|
702
|
+
* @param - The text the predictions will be based on.
|
|
703
|
+
*/
|
|
704
|
+
(input: string, options?: PredictOptions | undefined): Promise<PredictResponse & PredictResponseNonNullableFields>;
|
|
230
705
|
}
|
|
231
|
-
type RequestOptionsFactory$1<TResponse = any, TData = any> = (context: any) => RequestOptions$1<TResponse, TData>;
|
|
232
|
-
type HttpResponse$1<T = any> = {
|
|
233
|
-
data: T;
|
|
234
|
-
status: number;
|
|
235
|
-
statusText: string;
|
|
236
|
-
headers: any;
|
|
237
|
-
request?: any;
|
|
238
|
-
};
|
|
239
|
-
type RequestOptions$1<_TResponse = any, Data = any> = {
|
|
240
|
-
method: 'POST' | 'GET' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
|
|
241
|
-
url: string;
|
|
242
|
-
data?: Data;
|
|
243
|
-
params?: URLSearchParams;
|
|
244
|
-
} & APIMetadata$1;
|
|
245
|
-
type APIMetadata$1 = {
|
|
246
|
-
methodFqn?: string;
|
|
247
|
-
entityFqdn?: string;
|
|
248
|
-
packageName?: string;
|
|
249
|
-
};
|
|
250
706
|
|
|
251
|
-
declare const
|
|
252
|
-
PACKAGE_NAME: string;
|
|
253
|
-
};
|
|
254
|
-
declare function predict(httpClient: HttpClient$1): (input: string, options?: PredictOptions) => Promise<PredictResponse & PredictResponseNonNullableFields>;
|
|
707
|
+
declare const predict: MaybeContext<BuildRESTFunction<typeof predict$1> & typeof predict$1>;
|
|
255
708
|
|
|
256
709
|
type index_d$1_ListPredictionsRequest = ListPredictionsRequest;
|
|
257
710
|
type index_d$1_ListPredictionsResponse = ListPredictionsResponse;
|
|
@@ -264,7 +717,7 @@ type index_d$1_Prediction = Prediction;
|
|
|
264
717
|
type index_d$1_TextStructure = TextStructure;
|
|
265
718
|
declare const index_d$1_predict: typeof predict;
|
|
266
719
|
declare namespace index_d$1 {
|
|
267
|
-
export { type AddressLocation$1 as AddressLocation, type FilterBy$1 as FilterBy, FilterType$1 as FilterType, type index_d$1_ListPredictionsRequest as ListPredictionsRequest, type index_d$1_ListPredictionsResponse as ListPredictionsResponse, type index_d$1_MatchedSubstrings as MatchedSubstrings, type index_d$1_PredictOptions as PredictOptions, type index_d$1_PredictRequest as PredictRequest, type index_d$1_PredictResponse as PredictResponse, type index_d$1_PredictResponseNonNullableFields as PredictResponseNonNullableFields, type index_d$1_Prediction as Prediction, type index_d$1_TextStructure as TextStructure,
|
|
720
|
+
export { type AddressLocation$1 as AddressLocation, type FilterBy$1 as FilterBy, FilterType$1 as FilterType, type index_d$1_ListPredictionsRequest as ListPredictionsRequest, type index_d$1_ListPredictionsResponse as ListPredictionsResponse, type index_d$1_MatchedSubstrings as MatchedSubstrings, type index_d$1_PredictOptions as PredictOptions, type index_d$1_PredictRequest as PredictRequest, type index_d$1_PredictResponse as PredictResponse, type index_d$1_PredictResponseNonNullableFields as PredictResponseNonNullableFields, type index_d$1_Prediction as Prediction, type index_d$1_TextStructure as TextStructure, index_d$1_predict as predict };
|
|
268
721
|
}
|
|
269
722
|
|
|
270
723
|
interface SearchResult {
|
|
@@ -376,10 +829,20 @@ interface ReverseGeocodingRequest {
|
|
|
376
829
|
interface ReverseGeocodingResponse {
|
|
377
830
|
searchResults?: SearchResult[];
|
|
378
831
|
}
|
|
832
|
+
interface StreetAddressNonNullableFields {
|
|
833
|
+
number: string;
|
|
834
|
+
name: string;
|
|
835
|
+
apt: string;
|
|
836
|
+
}
|
|
837
|
+
interface AddressNonNullableFields {
|
|
838
|
+
streetAddress?: StreetAddressNonNullableFields;
|
|
839
|
+
}
|
|
840
|
+
interface SearchResultNonNullableFields {
|
|
841
|
+
address?: AddressNonNullableFields;
|
|
842
|
+
proximity: Proximity;
|
|
843
|
+
}
|
|
379
844
|
interface SearchResponseNonNullableFields {
|
|
380
|
-
searchResults:
|
|
381
|
-
proximity: Proximity;
|
|
382
|
-
}[];
|
|
845
|
+
searchResults: SearchResultNonNullableFields[];
|
|
383
846
|
}
|
|
384
847
|
interface SearchOptions {
|
|
385
848
|
/** Free text */
|
|
@@ -395,33 +858,15 @@ interface SearchOptions {
|
|
|
395
858
|
countryCodes?: string[];
|
|
396
859
|
}
|
|
397
860
|
|
|
398
|
-
|
|
399
|
-
|
|
861
|
+
declare function search$1(httpClient: HttpClient): SearchSignature;
|
|
862
|
+
interface SearchSignature {
|
|
863
|
+
/**
|
|
864
|
+
* A Search request takes a free text as an input and returns a list of 'Address' objects.
|
|
865
|
+
*/
|
|
866
|
+
(options?: SearchOptions | undefined): Promise<SearchResponse & SearchResponseNonNullableFields>;
|
|
400
867
|
}
|
|
401
|
-
type RequestOptionsFactory<TResponse = any, TData = any> = (context: any) => RequestOptions<TResponse, TData>;
|
|
402
|
-
type HttpResponse<T = any> = {
|
|
403
|
-
data: T;
|
|
404
|
-
status: number;
|
|
405
|
-
statusText: string;
|
|
406
|
-
headers: any;
|
|
407
|
-
request?: any;
|
|
408
|
-
};
|
|
409
|
-
type RequestOptions<_TResponse = any, Data = any> = {
|
|
410
|
-
method: 'POST' | 'GET' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
|
|
411
|
-
url: string;
|
|
412
|
-
data?: Data;
|
|
413
|
-
params?: URLSearchParams;
|
|
414
|
-
} & APIMetadata;
|
|
415
|
-
type APIMetadata = {
|
|
416
|
-
methodFqn?: string;
|
|
417
|
-
entityFqdn?: string;
|
|
418
|
-
packageName?: string;
|
|
419
|
-
};
|
|
420
868
|
|
|
421
|
-
declare const
|
|
422
|
-
PACKAGE_NAME: string;
|
|
423
|
-
};
|
|
424
|
-
declare function search(httpClient: HttpClient): (options?: SearchOptions) => Promise<SearchResponse & SearchResponseNonNullableFields>;
|
|
869
|
+
declare const search: MaybeContext<BuildRESTFunction<typeof search$1> & typeof search$1>;
|
|
425
870
|
|
|
426
871
|
type index_d_Address = Address;
|
|
427
872
|
type index_d_AddressLocation = AddressLocation;
|
|
@@ -442,10 +887,9 @@ type index_d_StreetAddress = StreetAddress;
|
|
|
442
887
|
type index_d_Subdivision = Subdivision;
|
|
443
888
|
type index_d_SubdivisionType = SubdivisionType;
|
|
444
889
|
declare const index_d_SubdivisionType: typeof SubdivisionType;
|
|
445
|
-
declare const index_d___metadata: typeof __metadata;
|
|
446
890
|
declare const index_d_search: typeof search;
|
|
447
891
|
declare namespace index_d {
|
|
448
|
-
export { type index_d_Address as Address, type index_d_AddressLocation as AddressLocation, type index_d_AddressStreetOneOf as AddressStreetOneOf, type index_d_FilterBy as FilterBy, index_d_FilterType as FilterType, index_d_Proximity as Proximity, type index_d_ReverseGeocodingRequest as ReverseGeocodingRequest, type index_d_ReverseGeocodingResponse as ReverseGeocodingResponse, type index_d_SearchOptions as SearchOptions, type index_d_SearchRequest as SearchRequest, type index_d_SearchResponse as SearchResponse, type index_d_SearchResponseNonNullableFields as SearchResponseNonNullableFields, type index_d_SearchResult as SearchResult, type index_d_StreetAddress as StreetAddress, type index_d_Subdivision as Subdivision, index_d_SubdivisionType as SubdivisionType,
|
|
892
|
+
export { type index_d_Address as Address, type index_d_AddressLocation as AddressLocation, type index_d_AddressStreetOneOf as AddressStreetOneOf, type index_d_FilterBy as FilterBy, index_d_FilterType as FilterType, index_d_Proximity as Proximity, type index_d_ReverseGeocodingRequest as ReverseGeocodingRequest, type index_d_ReverseGeocodingResponse as ReverseGeocodingResponse, type index_d_SearchOptions as SearchOptions, type index_d_SearchRequest as SearchRequest, type index_d_SearchResponse as SearchResponse, type index_d_SearchResponseNonNullableFields as SearchResponseNonNullableFields, type index_d_SearchResult as SearchResult, type index_d_StreetAddress as StreetAddress, type index_d_Subdivision as Subdivision, index_d_SubdivisionType as SubdivisionType, index_d_search as search };
|
|
449
893
|
}
|
|
450
894
|
|
|
451
895
|
export { index_d$1 as autocomplete, index_d as location, index_d$2 as places };
|