-
Notifications
You must be signed in to change notification settings - Fork 1.1k
/
Users.ts
114 lines (105 loc) · 3.85 KB
/
Users.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
// Copyright (c) Microsoft Corporation.
// Licensed under the MIT license.
import { ClientContext } from "../../ClientContext";
import { getIdFromLink, getPathFromLink, isResourceValid, ResourceType } from "../../common";
import { SqlQuerySpec } from "../../queryExecutionContext";
import { QueryIterator } from "../../queryIterator";
import { FeedOptions, RequestOptions } from "../../request";
import { Database } from "../Database";
import { Resource } from "../Resource";
import { User } from "./User";
import { UserDefinition } from "./UserDefinition";
import { UserResponse } from "./UserResponse";
/**
* Used to create, upsert, query, and read all users.
*
* @see {@link User} to read, replace, or delete a specific User by id.
*/
export class Users {
/**
* @hidden
* @param database The parent {@link Database}.
*/
constructor(public readonly database: Database, private readonly clientContext: ClientContext) {}
/**
* Query all users.
* @param query Query configuration for the operation. See {@link SqlQuerySpec} for more info on how to configure a query.
* @param options
*/
public query(query: SqlQuerySpec, options?: FeedOptions): QueryIterator<any>;
/**
* Query all users.
* @param query Query configuration for the operation. See {@link SqlQuerySpec} for more info on how to configure a query.
* @param options
*/
public query<T>(query: SqlQuerySpec, options?: FeedOptions): QueryIterator<T>;
public query<T>(query: SqlQuerySpec, options?: FeedOptions): QueryIterator<T> {
const path = getPathFromLink(this.database.url, ResourceType.user);
const id = getIdFromLink(this.database.url);
return new QueryIterator(this.clientContext, query, options, (innerOptions) => {
return this.clientContext.queryFeed({
path,
resourceType: ResourceType.user,
resourceId: id,
resultFn: (result) => result.Users,
query,
options: innerOptions
});
});
}
/**
* Read all users.
* @param options
* @example Read all users to array.
* ```typescript
* const {body: usersList} = await database.users.readAll().fetchAll();
* ```
*/
public readAll(options?: FeedOptions): QueryIterator<UserDefinition & Resource> {
return this.query<UserDefinition & Resource>(undefined, options);
}
/**
* Create a database user with the specified {@link UserDefinition}.
* @param body The specified {@link UserDefinition}.
* @param options
*/
public async create(body: UserDefinition, options?: RequestOptions): Promise<UserResponse> {
const err = {};
if (!isResourceValid(body, err)) {
throw err;
}
const path = getPathFromLink(this.database.url, ResourceType.user);
const id = getIdFromLink(this.database.url);
const response = await this.clientContext.create<UserDefinition>({
body,
path,
resourceType: ResourceType.user,
resourceId: id,
options
});
const ref = new User(this.database, response.result.id, this.clientContext);
return new UserResponse(response.result, response.headers, response.code, ref);
}
/**
* Upsert a database user with a specified {@link UserDefinition}.
* @param body The specified {@link UserDefinition}.
* @param options
*/
public async upsert(body: UserDefinition, options?: RequestOptions): Promise<UserResponse> {
const err = {};
if (!isResourceValid(body, err)) {
throw err;
}
const path = getPathFromLink(this.database.url, ResourceType.user);
const id = getIdFromLink(this.database.url);
const response = await this.clientContext.upsert<UserDefinition>({
body,
path,
resourceType: ResourceType.user,
resourceId: id,
options
});
const ref = new User(this.database, response.result.id, this.clientContext);
return new UserResponse(response.result, response.headers, response.code, ref);
}
}