gopadjs 2.8.0 → 2.9.0

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/.codacy.yml CHANGED
@@ -3,4 +3,7 @@ exclude_paths:
3
3
  - .github/**
4
4
  - CHANGELOG.md
5
5
 
6
+ - api/**
7
+ - model/**
8
+
6
9
  ...
package/.github/RELEASE CHANGED
@@ -1 +1 @@
1
- Mon Apr 21 08:13:43 UTC 2025
1
+ Mon Apr 28 08:32:02 UTC 2025
@@ -166,5 +166,8 @@ labels:
166
166
  - name: outdated
167
167
  color: cccccc
168
168
  description: This is out of scope and outdated
169
+ - name: openapi
170
+ color: 1f385c
171
+ description: Generated new SDK version from OpenAPI
169
172
 
170
173
  ...
@@ -8,6 +8,35 @@ api/user-api.ts
8
8
  base.ts
9
9
  common.ts
10
10
  configuration.ts
11
+ docs/AuthApi.md
12
+ docs/AuthToken.md
13
+ docs/AuthVerify.md
14
+ docs/CreateGroupRequest.md
15
+ docs/CreateUserRequest.md
16
+ docs/DeleteGroupFromUserRequest.md
17
+ docs/DeleteUserFromGroupRequest.md
18
+ docs/Group.md
19
+ docs/GroupApi.md
20
+ docs/ListGroupUsers200Response.md
21
+ docs/ListGroups200Response.md
22
+ docs/ListProviders200Response.md
23
+ docs/ListUserGroups200Response.md
24
+ docs/ListUsers200Response.md
25
+ docs/LoginAuthRequest.md
26
+ docs/Notification.md
27
+ docs/PermitGroupUserRequest.md
28
+ docs/PermitUserGroupRequest.md
29
+ docs/Profile.md
30
+ docs/ProfileApi.md
31
+ docs/Provider.md
32
+ docs/RedirectAuthRequest.md
33
+ docs/UpdateProfileRequest.md
34
+ docs/UpdateUserRequest.md
35
+ docs/User.md
36
+ docs/UserApi.md
37
+ docs/UserAuth.md
38
+ docs/UserGroup.md
39
+ docs/Validation.md
11
40
  index.ts
12
41
  model/auth-token.ts
13
42
  model/auth-verify.ts
@@ -1 +1 @@
1
- 7.12.0
1
+ 7.13.0
package/CHANGELOG.md CHANGED
@@ -1,5 +1,12 @@
1
1
  # Changelog
2
2
 
3
+ ## [2.9.0](https://github.com/gopad/gopad-js/compare/v2.8.0...v2.9.0) (2025-05-05)
4
+
5
+
6
+ ### Features
7
+
8
+ * automated openapi client update ([8b0a0cf](https://github.com/gopad/gopad-js/commit/8b0a0cf82c5358cafdb8fac84c56b6d09b111b10))
9
+
3
10
  ## [2.8.0](https://github.com/gopad/gopad-js/compare/v2.7.0...v2.8.0) (2025-04-28)
4
11
 
5
12
 
package/README.md CHANGED
@@ -6,7 +6,7 @@ This repository provides a client SDK for Typescript/Javascript. This SDK is
6
6
  automatically generated by the [OpenAPI Generator][generator] project:
7
7
 
8
8
  - API version: 1.0.0-alpha1
9
- - Package version: 2.8.0
9
+ - Package version: 2.9.0
10
10
  - Build package: org.openapitools.codegen.languages.TypeScriptAxiosClientCodegen
11
11
 
12
12
  For more information, please visit [https://gopad.eu](https://gopad.eu)
@@ -39,7 +39,7 @@ the following command within your project directory, after that you can import
39
39
  it as other libraries:
40
40
 
41
41
  ```console
42
- npm install --save gopadjs@2.8.0
42
+ npm install --save gopadjs@2.9.0
43
43
  ```
44
44
 
45
45
  ### Installation with Git
@@ -0,0 +1,366 @@
1
+ # AuthApi
2
+
3
+ All URIs are relative to *https://try.gopad.eu/api/v1*
4
+
5
+ |Method | HTTP request | Description|
6
+ |------------- | ------------- | -------------|
7
+ |[**callbackProvider**](#callbackprovider) | **GET** /auth/{provider}/callback | Callback to parse the defined provider|
8
+ |[**listProviders**](#listproviders) | **GET** /auth/providers | Fetch the available auth providers|
9
+ |[**loginAuth**](#loginauth) | **POST** /auth/login | Authenticate an user by credentials|
10
+ |[**redirectAuth**](#redirectauth) | **POST** /auth/redirect | Retrieve real token after redirect|
11
+ |[**refreshAuth**](#refreshauth) | **GET** /auth/refresh | Refresh an auth token before it expires|
12
+ |[**requestProvider**](#requestprovider) | **GET** /auth/{provider}/request | Request the redirect to defined provider|
13
+ |[**verifyAuth**](#verifyauth) | **GET** /auth/verify | Verify validity for an authentication token|
14
+
15
+ # **callbackProvider**
16
+ > callbackProvider()
17
+
18
+
19
+ ### Example
20
+
21
+ ```typescript
22
+ import {
23
+ AuthApi,
24
+ Configuration
25
+ } from 'gopadjs';
26
+
27
+ const configuration = new Configuration();
28
+ const apiInstance = new AuthApi(configuration);
29
+
30
+ let provider: string; //An identifier for the auth provider (default to undefined)
31
+ let state: string; //Auth state (optional) (default to undefined)
32
+ let code: string; //Auth code (optional) (default to undefined)
33
+
34
+ const { status, data } = await apiInstance.callbackProvider(
35
+ provider,
36
+ state,
37
+ code
38
+ );
39
+ ```
40
+
41
+ ### Parameters
42
+
43
+ |Name | Type | Description | Notes|
44
+ |------------- | ------------- | ------------- | -------------|
45
+ | **provider** | [**string**] | An identifier for the auth provider | defaults to undefined|
46
+ | **state** | [**string**] | Auth state | (optional) defaults to undefined|
47
+ | **code** | [**string**] | Auth code | (optional) defaults to undefined|
48
+
49
+
50
+ ### Return type
51
+
52
+ void (empty response body)
53
+
54
+ ### Authorization
55
+
56
+ No authorization required
57
+
58
+ ### HTTP request headers
59
+
60
+ - **Content-Type**: Not defined
61
+ - **Accept**: text/html
62
+
63
+
64
+ ### HTTP response details
65
+ | Status code | Description | Response headers |
66
+ |-------------|-------------|------------------|
67
+ |**308** | Generated expiring token | - |
68
+ |**412** | Failed to initialize provider | - |
69
+ |**404** | Provider not found | - |
70
+ |**500** | Internal server error | - |
71
+
72
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
73
+
74
+ # **listProviders**
75
+ > ListProviders200Response listProviders()
76
+
77
+
78
+ ### Example
79
+
80
+ ```typescript
81
+ import {
82
+ AuthApi,
83
+ Configuration
84
+ } from 'gopadjs';
85
+
86
+ const configuration = new Configuration();
87
+ const apiInstance = new AuthApi(configuration);
88
+
89
+ const { status, data } = await apiInstance.listProviders();
90
+ ```
91
+
92
+ ### Parameters
93
+ This endpoint does not have any parameters.
94
+
95
+
96
+ ### Return type
97
+
98
+ **ListProviders200Response**
99
+
100
+ ### Authorization
101
+
102
+ No authorization required
103
+
104
+ ### HTTP request headers
105
+
106
+ - **Content-Type**: Not defined
107
+ - **Accept**: application/json
108
+
109
+
110
+ ### HTTP response details
111
+ | Status code | Description | Response headers |
112
+ |-------------|-------------|------------------|
113
+ |**200** | A collection of auth providers | - |
114
+
115
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
116
+
117
+ # **loginAuth**
118
+ > AuthToken loginAuth(loginAuthRequest)
119
+
120
+
121
+ ### Example
122
+
123
+ ```typescript
124
+ import {
125
+ AuthApi,
126
+ Configuration,
127
+ LoginAuthRequest
128
+ } from 'gopadjs';
129
+
130
+ const configuration = new Configuration();
131
+ const apiInstance = new AuthApi(configuration);
132
+
133
+ let loginAuthRequest: LoginAuthRequest; //The credentials to authenticate
134
+
135
+ const { status, data } = await apiInstance.loginAuth(
136
+ loginAuthRequest
137
+ );
138
+ ```
139
+
140
+ ### Parameters
141
+
142
+ |Name | Type | Description | Notes|
143
+ |------------- | ------------- | ------------- | -------------|
144
+ | **loginAuthRequest** | **LoginAuthRequest**| The credentials to authenticate | |
145
+
146
+
147
+ ### Return type
148
+
149
+ **AuthToken**
150
+
151
+ ### Authorization
152
+
153
+ No authorization required
154
+
155
+ ### HTTP request headers
156
+
157
+ - **Content-Type**: application/json
158
+ - **Accept**: application/json
159
+
160
+
161
+ ### HTTP response details
162
+ | Status code | Description | Response headers |
163
+ |-------------|-------------|------------------|
164
+ |**200** | Generated token with expire date | - |
165
+ |**400** | Failed to parse request | - |
166
+ |**401** | Unauthorized with wrong credentials | - |
167
+ |**500** | Some internal server error | - |
168
+
169
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
170
+
171
+ # **redirectAuth**
172
+ > AuthToken redirectAuth(redirectAuthRequest)
173
+
174
+
175
+ ### Example
176
+
177
+ ```typescript
178
+ import {
179
+ AuthApi,
180
+ Configuration,
181
+ RedirectAuthRequest
182
+ } from 'gopadjs';
183
+
184
+ const configuration = new Configuration();
185
+ const apiInstance = new AuthApi(configuration);
186
+
187
+ let redirectAuthRequest: RedirectAuthRequest; //The redirect token to authenticate
188
+
189
+ const { status, data } = await apiInstance.redirectAuth(
190
+ redirectAuthRequest
191
+ );
192
+ ```
193
+
194
+ ### Parameters
195
+
196
+ |Name | Type | Description | Notes|
197
+ |------------- | ------------- | ------------- | -------------|
198
+ | **redirectAuthRequest** | **RedirectAuthRequest**| The redirect token to authenticate | |
199
+
200
+
201
+ ### Return type
202
+
203
+ **AuthToken**
204
+
205
+ ### Authorization
206
+
207
+ No authorization required
208
+
209
+ ### HTTP request headers
210
+
211
+ - **Content-Type**: application/json
212
+ - **Accept**: application/json
213
+
214
+
215
+ ### HTTP response details
216
+ | Status code | Description | Response headers |
217
+ |-------------|-------------|------------------|
218
+ |**200** | Generated token never expiring | - |
219
+ |**400** | Failed to parse request | - |
220
+ |**401** | Failed to generate or validate token | - |
221
+ |**500** | Some internal server error | - |
222
+
223
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
224
+
225
+ # **refreshAuth**
226
+ > AuthToken refreshAuth()
227
+
228
+
229
+ ### Example
230
+
231
+ ```typescript
232
+ import {
233
+ AuthApi,
234
+ Configuration
235
+ } from 'gopadjs';
236
+
237
+ const configuration = new Configuration();
238
+ const apiInstance = new AuthApi(configuration);
239
+
240
+ const { status, data } = await apiInstance.refreshAuth();
241
+ ```
242
+
243
+ ### Parameters
244
+ This endpoint does not have any parameters.
245
+
246
+
247
+ ### Return type
248
+
249
+ **AuthToken**
250
+
251
+ ### Authorization
252
+
253
+ [Basic](../README.md#Basic), [Header](../README.md#Header), [Bearer](../README.md#Bearer)
254
+
255
+ ### HTTP request headers
256
+
257
+ - **Content-Type**: Not defined
258
+ - **Accept**: application/json
259
+
260
+
261
+ ### HTTP response details
262
+ | Status code | Description | Response headers |
263
+ |-------------|-------------|------------------|
264
+ |**200** | Refreshed token with expire date | - |
265
+ |**401** | Failed to generate or validate token | - |
266
+ |**500** | Some internal server error | - |
267
+
268
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
269
+
270
+ # **requestProvider**
271
+ > requestProvider()
272
+
273
+
274
+ ### Example
275
+
276
+ ```typescript
277
+ import {
278
+ AuthApi,
279
+ Configuration
280
+ } from 'gopadjs';
281
+
282
+ const configuration = new Configuration();
283
+ const apiInstance = new AuthApi(configuration);
284
+
285
+ let provider: string; //An identifier for the auth provider (default to undefined)
286
+
287
+ const { status, data } = await apiInstance.requestProvider(
288
+ provider
289
+ );
290
+ ```
291
+
292
+ ### Parameters
293
+
294
+ |Name | Type | Description | Notes|
295
+ |------------- | ------------- | ------------- | -------------|
296
+ | **provider** | [**string**] | An identifier for the auth provider | defaults to undefined|
297
+
298
+
299
+ ### Return type
300
+
301
+ void (empty response body)
302
+
303
+ ### Authorization
304
+
305
+ No authorization required
306
+
307
+ ### HTTP request headers
308
+
309
+ - **Content-Type**: Not defined
310
+ - **Accept**: text/html
311
+
312
+
313
+ ### HTTP response details
314
+ | Status code | Description | Response headers |
315
+ |-------------|-------------|------------------|
316
+ |**308** | Redirect to the provider | - |
317
+ |**404** | Provider not found | - |
318
+ |**500** | Internal server error | - |
319
+
320
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
321
+
322
+ # **verifyAuth**
323
+ > AuthVerify verifyAuth()
324
+
325
+
326
+ ### Example
327
+
328
+ ```typescript
329
+ import {
330
+ AuthApi,
331
+ Configuration
332
+ } from 'gopadjs';
333
+
334
+ const configuration = new Configuration();
335
+ const apiInstance = new AuthApi(configuration);
336
+
337
+ const { status, data } = await apiInstance.verifyAuth();
338
+ ```
339
+
340
+ ### Parameters
341
+ This endpoint does not have any parameters.
342
+
343
+
344
+ ### Return type
345
+
346
+ **AuthVerify**
347
+
348
+ ### Authorization
349
+
350
+ [Basic](../README.md#Basic), [Header](../README.md#Header), [Bearer](../README.md#Bearer)
351
+
352
+ ### HTTP request headers
353
+
354
+ - **Content-Type**: Not defined
355
+ - **Accept**: application/json
356
+
357
+
358
+ ### HTTP response details
359
+ | Status code | Description | Response headers |
360
+ |-------------|-------------|------------------|
361
+ |**200** | Metadata of the auth token | - |
362
+ |**401** | Failed to generate or validate token | - |
363
+ |**500** | Some internal server error | - |
364
+
365
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
366
+
@@ -0,0 +1,22 @@
1
+ # AuthToken
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **token** | **string** | | [readonly] [default to undefined]
9
+ **expires_at** | **string** | | [optional] [readonly] [default to undefined]
10
+
11
+ ## Example
12
+
13
+ ```typescript
14
+ import { AuthToken } from 'gopadjs';
15
+
16
+ const instance: AuthToken = {
17
+ token,
18
+ expires_at,
19
+ };
20
+ ```
21
+
22
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,22 @@
1
+ # AuthVerify
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **username** | **string** | | [readonly] [default to undefined]
9
+ **created_at** | **string** | | [optional] [readonly] [default to undefined]
10
+
11
+ ## Example
12
+
13
+ ```typescript
14
+ import { AuthVerify } from 'gopadjs';
15
+
16
+ const instance: AuthVerify = {
17
+ username,
18
+ created_at,
19
+ };
20
+ ```
21
+
22
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,22 @@
1
+ # CreateGroupRequest
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **slug** | **string** | | [optional] [default to undefined]
9
+ **name** | **string** | | [optional] [default to undefined]
10
+
11
+ ## Example
12
+
13
+ ```typescript
14
+ import { CreateGroupRequest } from 'gopadjs';
15
+
16
+ const instance: CreateGroupRequest = {
17
+ slug,
18
+ name,
19
+ };
20
+ ```
21
+
22
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,30 @@
1
+ # CreateUserRequest
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **username** | **string** | | [optional] [default to undefined]
9
+ **password** | **string** | | [optional] [default to undefined]
10
+ **email** | **string** | | [optional] [default to undefined]
11
+ **fullname** | **string** | | [optional] [default to undefined]
12
+ **admin** | **boolean** | | [optional] [default to false]
13
+ **active** | **boolean** | | [optional] [default to true]
14
+
15
+ ## Example
16
+
17
+ ```typescript
18
+ import { CreateUserRequest } from 'gopadjs';
19
+
20
+ const instance: CreateUserRequest = {
21
+ username,
22
+ password,
23
+ email,
24
+ fullname,
25
+ admin,
26
+ active,
27
+ };
28
+ ```
29
+
30
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,20 @@
1
+ # DeleteGroupFromUserRequest
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **user** | **string** | | [default to undefined]
9
+
10
+ ## Example
11
+
12
+ ```typescript
13
+ import { DeleteGroupFromUserRequest } from 'gopadjs';
14
+
15
+ const instance: DeleteGroupFromUserRequest = {
16
+ user,
17
+ };
18
+ ```
19
+
20
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,20 @@
1
+ # DeleteUserFromGroupRequest
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **group** | **string** | | [default to undefined]
9
+
10
+ ## Example
11
+
12
+ ```typescript
13
+ import { DeleteUserFromGroupRequest } from 'gopadjs';
14
+
15
+ const instance: DeleteUserFromGroupRequest = {
16
+ group,
17
+ };
18
+ ```
19
+
20
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
package/docs/Group.md ADDED
@@ -0,0 +1,29 @@
1
+ # Group
2
+
3
+ Model to represent group
4
+
5
+ ## Properties
6
+
7
+ Name | Type | Description | Notes
8
+ ------------ | ------------- | ------------- | -------------
9
+ **id** | **string** | | [optional] [default to undefined]
10
+ **slug** | **string** | | [optional] [default to undefined]
11
+ **name** | **string** | | [optional] [default to undefined]
12
+ **created_at** | **string** | | [optional] [readonly] [default to undefined]
13
+ **updated_at** | **string** | | [optional] [readonly] [default to undefined]
14
+
15
+ ## Example
16
+
17
+ ```typescript
18
+ import { Group } from 'gopadjs';
19
+
20
+ const instance: Group = {
21
+ id,
22
+ slug,
23
+ name,
24
+ created_at,
25
+ updated_at,
26
+ };
27
+ ```
28
+
29
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)