@perpetualsystems/typescript-sdk 0.0.0-bootstrap.0 → 0.4.0-next-20261110214241
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/README.md +26 -1
- package/dist/authorization-code-pkce.d.ts +40 -0
- package/dist/authorization-code-pkce.d.ts.map +1 -0
- package/dist/authorization-code-pkce.js +272 -0
- package/dist/authorization-code-pkce.js.map +1 -0
- package/dist/client-credentials.d.ts +18 -0
- package/dist/client-credentials.d.ts.map +1 -0
- package/dist/client-credentials.js +79 -0
- package/dist/client-credentials.js.map +1 -0
- package/dist/client-store.d.ts +37 -0
- package/dist/client-store.d.ts.map +1 -0
- package/dist/client-store.js +138 -0
- package/dist/client-store.js.map +1 -0
- package/dist/client.d.ts +113 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/client.js +217 -0
- package/dist/client.js.map +1 -0
- package/dist/config-dir.d.ts +3 -0
- package/dist/config-dir.d.ts.map +1 -0
- package/dist/config-dir.js +11 -0
- package/dist/config-dir.js.map +1 -0
- package/dist/dynamic-registration.d.ts +28 -0
- package/dist/dynamic-registration.d.ts.map +1 -0
- package/dist/dynamic-registration.js +56 -0
- package/dist/dynamic-registration.js.map +1 -0
- package/dist/generated/client/client.gen.d.ts +3 -0
- package/dist/generated/client/client.gen.d.ts.map +1 -0
- package/dist/generated/client/client.gen.js +217 -0
- package/dist/generated/client/client.gen.js.map +1 -0
- package/dist/generated/client/index.d.ts +11 -0
- package/dist/generated/client/index.d.ts.map +1 -0
- package/dist/generated/client/index.js +7 -0
- package/dist/generated/client/index.js.map +1 -0
- package/dist/generated/client/types.gen.d.ts +121 -0
- package/dist/generated/client/types.gen.d.ts.map +1 -0
- package/dist/generated/client/types.gen.js +3 -0
- package/dist/generated/client/types.gen.js.map +1 -0
- package/dist/generated/client/utils.gen.d.ts +38 -0
- package/dist/generated/client/utils.gen.d.ts.map +1 -0
- package/dist/generated/client/utils.gen.js +229 -0
- package/dist/generated/client/utils.gen.js.map +1 -0
- package/dist/generated/client.gen.d.ts +13 -0
- package/dist/generated/client.gen.d.ts.map +1 -0
- package/dist/generated/client.gen.js +4 -0
- package/dist/generated/client.gen.js.map +1 -0
- package/dist/generated/core/auth.gen.d.ts +26 -0
- package/dist/generated/core/auth.gen.d.ts.map +1 -0
- package/dist/generated/core/auth.gen.js +15 -0
- package/dist/generated/core/auth.gen.js.map +1 -0
- package/dist/generated/core/bodySerializer.gen.d.ts +26 -0
- package/dist/generated/core/bodySerializer.gen.d.ts.map +1 -0
- package/dist/generated/core/bodySerializer.gen.js +58 -0
- package/dist/generated/core/bodySerializer.gen.js.map +1 -0
- package/dist/generated/core/params.gen.d.ts +44 -0
- package/dist/generated/core/params.gen.d.ts.map +1 -0
- package/dist/generated/core/params.gen.js +110 -0
- package/dist/generated/core/params.gen.js.map +1 -0
- package/dist/generated/core/pathSerializer.gen.d.ts +34 -0
- package/dist/generated/core/pathSerializer.gen.d.ts.map +1 -0
- package/dist/generated/core/pathSerializer.gen.js +107 -0
- package/dist/generated/core/pathSerializer.gen.js.map +1 -0
- package/dist/generated/core/queryKeySerializer.gen.d.ts +19 -0
- package/dist/generated/core/queryKeySerializer.gen.d.ts.map +1 -0
- package/dist/generated/core/queryKeySerializer.gen.js +93 -0
- package/dist/generated/core/queryKeySerializer.gen.js.map +1 -0
- package/dist/generated/core/serverSentEvents.gen.d.ts +72 -0
- package/dist/generated/core/serverSentEvents.gen.d.ts.map +1 -0
- package/dist/generated/core/serverSentEvents.gen.js +133 -0
- package/dist/generated/core/serverSentEvents.gen.js.map +1 -0
- package/dist/generated/core/types.gen.d.ts +84 -0
- package/dist/generated/core/types.gen.d.ts.map +1 -0
- package/dist/generated/core/types.gen.js +3 -0
- package/dist/generated/core/types.gen.js.map +1 -0
- package/dist/generated/core/utils.gen.d.ts +20 -0
- package/dist/generated/core/utils.gen.d.ts.map +1 -0
- package/dist/generated/core/utils.gen.js +88 -0
- package/dist/generated/core/utils.gen.js.map +1 -0
- package/dist/generated/enum-values.gen.d.ts +331 -0
- package/dist/generated/enum-values.gen.d.ts.map +1 -0
- package/dist/generated/enum-values.gen.js +332 -0
- package/dist/generated/enum-values.gen.js.map +1 -0
- package/dist/generated/file-schemas.gen.d.ts +14 -0
- package/dist/generated/file-schemas.gen.d.ts.map +1 -0
- package/dist/generated/file-schemas.gen.js +3786 -0
- package/dist/generated/file-schemas.gen.js.map +1 -0
- package/dist/generated/index.d.ts +3 -0
- package/dist/generated/index.d.ts.map +1 -0
- package/dist/generated/index.js +3 -0
- package/dist/generated/index.js.map +1 -0
- package/dist/generated/sdk.gen.d.ts +1713 -0
- package/dist/generated/sdk.gen.d.ts.map +1 -0
- package/dist/generated/sdk.gen.js +10574 -0
- package/dist/generated/sdk.gen.js.map +1 -0
- package/dist/generated/spec-source.gen.d.ts +8 -0
- package/dist/generated/spec-source.gen.d.ts.map +1 -0
- package/dist/generated/spec-source.gen.js +9 -0
- package/dist/generated/spec-source.gen.js.map +1 -0
- package/dist/generated/types.gen.d.ts +30382 -0
- package/dist/generated/types.gen.d.ts.map +1 -0
- package/dist/generated/types.gen.js +3 -0
- package/dist/generated/types.gen.js.map +1 -0
- package/dist/index.d.ts +21 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +16 -0
- package/dist/index.js.map +1 -0
- package/dist/oauth-request-error.d.ts +26 -0
- package/dist/oauth-request-error.d.ts.map +1 -0
- package/dist/oauth-request-error.js +47 -0
- package/dist/oauth-request-error.js.map +1 -0
- package/dist/refresh-token.d.ts +50 -0
- package/dist/refresh-token.d.ts.map +1 -0
- package/dist/refresh-token.js +83 -0
- package/dist/refresh-token.js.map +1 -0
- package/dist/token-store.d.ts +38 -0
- package/dist/token-store.d.ts.map +1 -0
- package/dist/token-store.js +195 -0
- package/dist/token-store.js.map +1 -0
- package/openapi/openapi.json +128387 -0
- package/package.json +66 -4
- package/src/__tests__/authorization-code-pkce.test.ts +245 -0
- package/src/__tests__/client-credentials.test.ts +360 -0
- package/src/__tests__/client-store.test.ts +139 -0
- package/src/__tests__/client.test.ts +529 -0
- package/src/__tests__/config-dir.test.ts +22 -0
- package/src/__tests__/dynamic-registration.test.ts +181 -0
- package/src/__tests__/oauth-request-error.test.ts +148 -0
- package/src/__tests__/refresh-token.test.ts +206 -0
- package/src/__tests__/token-store.test.ts +449 -0
- package/src/authorization-code-pkce.ts +417 -0
- package/src/client-credentials.ts +127 -0
- package/src/client-store.ts +182 -0
- package/src/client.ts +261 -0
- package/src/config-dir.ts +12 -0
- package/src/dynamic-registration.ts +109 -0
- package/src/generated/client/client.gen.ts +277 -0
- package/src/generated/client/index.ts +27 -0
- package/src/generated/client/types.gen.ts +218 -0
- package/src/generated/client/utils.gen.ts +316 -0
- package/src/generated/client.gen.ts +16 -0
- package/src/generated/core/auth.gen.ts +48 -0
- package/src/generated/core/bodySerializer.gen.ts +82 -0
- package/src/generated/core/params.gen.ts +178 -0
- package/src/generated/core/pathSerializer.gen.ts +171 -0
- package/src/generated/core/queryKeySerializer.gen.ts +117 -0
- package/src/generated/core/serverSentEvents.gen.ts +242 -0
- package/src/generated/core/types.gen.ts +110 -0
- package/src/generated/core/utils.gen.ts +140 -0
- package/src/generated/enum-values.gen.ts +332 -0
- package/src/generated/file-schemas.gen.ts +3800 -0
- package/src/generated/index.ts +4 -0
- package/src/generated/sdk.gen.ts +10992 -0
- package/src/generated/spec-source.gen.ts +9 -0
- package/src/generated/types.gen.ts +32415 -0
- package/src/index.ts +55 -0
- package/src/oauth-request-error.ts +75 -0
- package/src/refresh-token.ts +142 -0
- package/src/token-store.ts +252 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client-store.js","sourceRoot":"","sources":["../src/client-store.ts"],"names":[],"mappings":"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"}
|
package/dist/client.d.ts
ADDED
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
import type { AuthorizationCodePkceOptions } from "./authorization-code-pkce.js";
|
|
2
|
+
import type { ClientCredentialsOptions } from "./client-credentials.js";
|
|
3
|
+
import type { Client } from "./generated/client/index.js";
|
|
4
|
+
export interface PerpetualClientOptions {
|
|
5
|
+
endpoint: string;
|
|
6
|
+
/** Request timeout in milliseconds. When set, each fetch request will be aborted if it exceeds this duration. */
|
|
7
|
+
timeout?: number;
|
|
8
|
+
}
|
|
9
|
+
export declare class PerpetualClient {
|
|
10
|
+
private _client;
|
|
11
|
+
private endpoint;
|
|
12
|
+
private _token;
|
|
13
|
+
constructor(options: PerpetualClientOptions);
|
|
14
|
+
/**
|
|
15
|
+
* Get the underlying SDK client for direct API calls.
|
|
16
|
+
* Use with generated SDK functions like dashboardsList, dashboardsCreate, etc.
|
|
17
|
+
*
|
|
18
|
+
* @example
|
|
19
|
+
* ```ts
|
|
20
|
+
* import { dashboardsList } from "./generated/sdk.gen.js";
|
|
21
|
+
*
|
|
22
|
+
* const response = await dashboardsList({
|
|
23
|
+
* client: perpetual.client,
|
|
24
|
+
* path: { orgId },
|
|
25
|
+
* headers: perpetual.getAuthHeaders(),
|
|
26
|
+
* });
|
|
27
|
+
* ```
|
|
28
|
+
*/
|
|
29
|
+
get client(): Client;
|
|
30
|
+
/**
|
|
31
|
+
* Get the normalized endpoint URL (lowercase host, no trailing slash).
|
|
32
|
+
* Use as a key for the token store.
|
|
33
|
+
*/
|
|
34
|
+
get endpointUrl(): string;
|
|
35
|
+
/**
|
|
36
|
+
* Get the current authentication token, or null if not authenticated.
|
|
37
|
+
*/
|
|
38
|
+
get token(): string | null;
|
|
39
|
+
/**
|
|
40
|
+
* Get headers with Bearer token if available.
|
|
41
|
+
* Sends both cookie variants to support local (http) and production (https) environments.
|
|
42
|
+
*
|
|
43
|
+
* Use this with SDK calls that require authentication:
|
|
44
|
+
* ```ts
|
|
45
|
+
* const response = await dashboardsList({
|
|
46
|
+
* client: perpetual.client,
|
|
47
|
+
* path: { orgId },
|
|
48
|
+
* headers: perpetual.getAuthHeaders(),
|
|
49
|
+
* });
|
|
50
|
+
* ```
|
|
51
|
+
*/
|
|
52
|
+
getAuthHeaders(): Record<string, string>;
|
|
53
|
+
/**
|
|
54
|
+
* Check if the client has an active authentication token.
|
|
55
|
+
*/
|
|
56
|
+
get isAuthenticated(): boolean;
|
|
57
|
+
/**
|
|
58
|
+
* Set the authentication token directly, e.g. when restoring from a stored profile.
|
|
59
|
+
* @param token - A previously obtained session token
|
|
60
|
+
*/
|
|
61
|
+
setToken(token: string): void;
|
|
62
|
+
/**
|
|
63
|
+
* Login via the OAuth 2.0 Authorization Code flow with PKCE
|
|
64
|
+
* (RFC 6749 §4.1 + RFC 7636). Opens a browser for the user to authorize,
|
|
65
|
+
* catches the redirect on a localhost loopback, and exchanges the code
|
|
66
|
+
* for a token. Replaces the prior device-code flow which the Perpetual
|
|
67
|
+
* backend no longer supports.
|
|
68
|
+
*
|
|
69
|
+
* @param clientId - OAuth client ID registered with the server (typically
|
|
70
|
+
* obtained via Dynamic Client Registration; see `registerClient`)
|
|
71
|
+
* @param redirectUri - Loopback redirect URI registered with the AS;
|
|
72
|
+
* the SDK will start an HTTP server bound to its host:port to catch
|
|
73
|
+
* the callback. Use `http://127.0.0.1:PORT/callback`.
|
|
74
|
+
* @param options - Optional client_secret, log/open overrides for testing,
|
|
75
|
+
* and timeout. The Perpetual backend issues a secret on registration
|
|
76
|
+
* even for PKCE-only clients; pass it here when present.
|
|
77
|
+
* @returns Object containing the access token and optional refresh token
|
|
78
|
+
* + expiration in seconds.
|
|
79
|
+
*/
|
|
80
|
+
loginInteractive(clientId: string, redirectUri: string, options?: Pick<AuthorizationCodePkceOptions, "clientSecret" | "scope" | "log" | "_openUrl" | "_fetch" | "timeoutMs">): Promise<{
|
|
81
|
+
token: string;
|
|
82
|
+
refreshToken?: string;
|
|
83
|
+
expiresIn?: number;
|
|
84
|
+
}>;
|
|
85
|
+
/**
|
|
86
|
+
* Login via OAuth Client Credentials Grant (RFC 6749 §4.4).
|
|
87
|
+
* Exchanges client_id + client_secret for an access token.
|
|
88
|
+
*
|
|
89
|
+
* @param clientId - OAuth client ID
|
|
90
|
+
* @param clientSecret - OAuth client secret
|
|
91
|
+
* @param options - Optional fetch override for testing
|
|
92
|
+
* @returns Object containing the access token and optional expiration in seconds
|
|
93
|
+
*/
|
|
94
|
+
loginClientCredentials(clientId: string, clientSecret: string, options?: Pick<ClientCredentialsOptions, "_fetch">): Promise<{
|
|
95
|
+
token: string;
|
|
96
|
+
expiresIn?: number;
|
|
97
|
+
}>;
|
|
98
|
+
/**
|
|
99
|
+
* Login with username and password.
|
|
100
|
+
* @param username - User's email address
|
|
101
|
+
* @param password - User's password
|
|
102
|
+
* @returns The userId from the session
|
|
103
|
+
* @throws Error if authentication fails or token cannot be extracted
|
|
104
|
+
*/
|
|
105
|
+
login(username: string, password: string): Promise<string>;
|
|
106
|
+
/**
|
|
107
|
+
* Logout and destroy the current session.
|
|
108
|
+
* Idempotent - safe to call even if not logged in or if server call fails.
|
|
109
|
+
* Always clears local token regardless of server response.
|
|
110
|
+
*/
|
|
111
|
+
logout(): Promise<void>;
|
|
112
|
+
}
|
|
113
|
+
//# sourceMappingURL=client.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAEjF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAExE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAK1D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,iHAAiH;IACjH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAuB;IAErC,YAAY,OAAO,EAAE,sBAAsB,EAgB1C;IAED;;;;;;;;;;;;;;OAcG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;OAGG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,GAAG,IAAI,CAEzB;IAED;;;;;;;;;;;;OAYG;IACH,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQvC;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAK5B;IAED;;;;;;;;;;;;;;;;;OAiBG;IACG,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,IAAI,CACZ,4BAA4B,EAC5B,cAAc,GAAG,OAAO,GAAG,KAAK,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,CACvE,GACA,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAavE;IAED;;;;;;;;OAQG;IACG,sBAAsB,CAC1B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,QAAQ,CAAC,GACjD,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAShD;IAED;;;;;;OAMG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyC/D;IAED;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CA2B5B;CACF"}
|
package/dist/client.js
ADDED
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
import { executeAuthorizationCodePkce } from "./authorization-code-pkce.js";
|
|
2
|
+
import { exchangeClientCredentials } from "./client-credentials.js";
|
|
3
|
+
import { createClient, createConfig } from "./generated/client/index.js";
|
|
4
|
+
import { sessionCreate, sessionDelete } from "./generated/sdk.gen.js";
|
|
5
|
+
import { normalizeEndpoint } from "./token-store.js";
|
|
6
|
+
export class PerpetualClient {
|
|
7
|
+
_client;
|
|
8
|
+
endpoint;
|
|
9
|
+
_token = null;
|
|
10
|
+
constructor(options) {
|
|
11
|
+
this.endpoint = normalizeEndpoint(options.endpoint);
|
|
12
|
+
const config = {
|
|
13
|
+
baseUrl: `${this.endpoint}/api/v0`,
|
|
14
|
+
};
|
|
15
|
+
if (options.timeout != null && options.timeout > 0) {
|
|
16
|
+
const ms = options.timeout;
|
|
17
|
+
config.fetch = (input, init) => {
|
|
18
|
+
const timeoutSignal = AbortSignal.timeout(ms);
|
|
19
|
+
const signal = init?.signal
|
|
20
|
+
? AbortSignal.any([init.signal, timeoutSignal])
|
|
21
|
+
: timeoutSignal;
|
|
22
|
+
return fetch(input, { ...init, signal });
|
|
23
|
+
};
|
|
24
|
+
}
|
|
25
|
+
this._client = createClient(createConfig(config));
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Get the underlying SDK client for direct API calls.
|
|
29
|
+
* Use with generated SDK functions like dashboardsList, dashboardsCreate, etc.
|
|
30
|
+
*
|
|
31
|
+
* @example
|
|
32
|
+
* ```ts
|
|
33
|
+
* import { dashboardsList } from "./generated/sdk.gen.js";
|
|
34
|
+
*
|
|
35
|
+
* const response = await dashboardsList({
|
|
36
|
+
* client: perpetual.client,
|
|
37
|
+
* path: { orgId },
|
|
38
|
+
* headers: perpetual.getAuthHeaders(),
|
|
39
|
+
* });
|
|
40
|
+
* ```
|
|
41
|
+
*/
|
|
42
|
+
get client() {
|
|
43
|
+
return this._client;
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* Get the normalized endpoint URL (lowercase host, no trailing slash).
|
|
47
|
+
* Use as a key for the token store.
|
|
48
|
+
*/
|
|
49
|
+
get endpointUrl() {
|
|
50
|
+
return this.endpoint;
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Get the current authentication token, or null if not authenticated.
|
|
54
|
+
*/
|
|
55
|
+
get token() {
|
|
56
|
+
return this._token;
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* Get headers with Bearer token if available.
|
|
60
|
+
* Sends both cookie variants to support local (http) and production (https) environments.
|
|
61
|
+
*
|
|
62
|
+
* Use this with SDK calls that require authentication:
|
|
63
|
+
* ```ts
|
|
64
|
+
* const response = await dashboardsList({
|
|
65
|
+
* client: perpetual.client,
|
|
66
|
+
* path: { orgId },
|
|
67
|
+
* headers: perpetual.getAuthHeaders(),
|
|
68
|
+
* });
|
|
69
|
+
* ```
|
|
70
|
+
*/
|
|
71
|
+
getAuthHeaders() {
|
|
72
|
+
if (this._token) {
|
|
73
|
+
return {
|
|
74
|
+
Authorization: `Bearer ${this._token}`,
|
|
75
|
+
Cookie: `better-auth.session_token=${this._token}; __Secure-better-auth.session_token=${this._token}`,
|
|
76
|
+
};
|
|
77
|
+
}
|
|
78
|
+
return {};
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* Check if the client has an active authentication token.
|
|
82
|
+
*/
|
|
83
|
+
get isAuthenticated() {
|
|
84
|
+
return this._token !== null;
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* Set the authentication token directly, e.g. when restoring from a stored profile.
|
|
88
|
+
* @param token - A previously obtained session token
|
|
89
|
+
*/
|
|
90
|
+
setToken(token) {
|
|
91
|
+
if (!token) {
|
|
92
|
+
throw new Error("Cannot set empty token");
|
|
93
|
+
}
|
|
94
|
+
this._token = token;
|
|
95
|
+
}
|
|
96
|
+
/**
|
|
97
|
+
* Login via the OAuth 2.0 Authorization Code flow with PKCE
|
|
98
|
+
* (RFC 6749 §4.1 + RFC 7636). Opens a browser for the user to authorize,
|
|
99
|
+
* catches the redirect on a localhost loopback, and exchanges the code
|
|
100
|
+
* for a token. Replaces the prior device-code flow which the Perpetual
|
|
101
|
+
* backend no longer supports.
|
|
102
|
+
*
|
|
103
|
+
* @param clientId - OAuth client ID registered with the server (typically
|
|
104
|
+
* obtained via Dynamic Client Registration; see `registerClient`)
|
|
105
|
+
* @param redirectUri - Loopback redirect URI registered with the AS;
|
|
106
|
+
* the SDK will start an HTTP server bound to its host:port to catch
|
|
107
|
+
* the callback. Use `http://127.0.0.1:PORT/callback`.
|
|
108
|
+
* @param options - Optional client_secret, log/open overrides for testing,
|
|
109
|
+
* and timeout. The Perpetual backend issues a secret on registration
|
|
110
|
+
* even for PKCE-only clients; pass it here when present.
|
|
111
|
+
* @returns Object containing the access token and optional refresh token
|
|
112
|
+
* + expiration in seconds.
|
|
113
|
+
*/
|
|
114
|
+
async loginInteractive(clientId, redirectUri, options) {
|
|
115
|
+
const result = await executeAuthorizationCodePkce({
|
|
116
|
+
endpoint: this.endpoint,
|
|
117
|
+
clientId,
|
|
118
|
+
redirectUri,
|
|
119
|
+
...options,
|
|
120
|
+
});
|
|
121
|
+
this._token = result.token;
|
|
122
|
+
return {
|
|
123
|
+
token: result.token,
|
|
124
|
+
refreshToken: result.refreshToken,
|
|
125
|
+
expiresIn: result.expiresIn,
|
|
126
|
+
};
|
|
127
|
+
}
|
|
128
|
+
/**
|
|
129
|
+
* Login via OAuth Client Credentials Grant (RFC 6749 §4.4).
|
|
130
|
+
* Exchanges client_id + client_secret for an access token.
|
|
131
|
+
*
|
|
132
|
+
* @param clientId - OAuth client ID
|
|
133
|
+
* @param clientSecret - OAuth client secret
|
|
134
|
+
* @param options - Optional fetch override for testing
|
|
135
|
+
* @returns Object containing the access token and optional expiration in seconds
|
|
136
|
+
*/
|
|
137
|
+
async loginClientCredentials(clientId, clientSecret, options) {
|
|
138
|
+
const result = await exchangeClientCredentials({
|
|
139
|
+
endpoint: this.endpoint,
|
|
140
|
+
clientId,
|
|
141
|
+
clientSecret,
|
|
142
|
+
...options,
|
|
143
|
+
});
|
|
144
|
+
this._token = result.access_token;
|
|
145
|
+
return { token: result.access_token, expiresIn: result.expires_in };
|
|
146
|
+
}
|
|
147
|
+
/**
|
|
148
|
+
* Login with username and password.
|
|
149
|
+
* @param username - User's email address
|
|
150
|
+
* @param password - User's password
|
|
151
|
+
* @returns The userId from the session
|
|
152
|
+
* @throws Error if authentication fails or token cannot be extracted
|
|
153
|
+
*/
|
|
154
|
+
async login(username, password) {
|
|
155
|
+
const response = await sessionCreate({
|
|
156
|
+
client: this._client,
|
|
157
|
+
body: { username, password },
|
|
158
|
+
throwOnError: true,
|
|
159
|
+
});
|
|
160
|
+
if (!response.data) {
|
|
161
|
+
throw new Error("Login failed: no data returned from server");
|
|
162
|
+
}
|
|
163
|
+
if (!response.data.userId || typeof response.data.userId !== "string") {
|
|
164
|
+
throw new Error("Login failed: userId missing from response");
|
|
165
|
+
}
|
|
166
|
+
// Extract token from set-cookie header
|
|
167
|
+
const setCookie = response.response.headers.get("set-cookie");
|
|
168
|
+
if (!setCookie) {
|
|
169
|
+
throw new Error("Login failed: no set-cookie header in response. Server may not be returning session token.");
|
|
170
|
+
}
|
|
171
|
+
const tokenMatch = setCookie.match(/(?:^|;\s*)(?:__Secure-)?better-auth\.session_token=([^;]+)/);
|
|
172
|
+
if (!tokenMatch?.[1] || tokenMatch[1].trim() === "") {
|
|
173
|
+
throw new Error("Login failed: token value in set-cookie header is empty or invalid");
|
|
174
|
+
}
|
|
175
|
+
// Decode URL-encoded token values (cookies may be percent-encoded)
|
|
176
|
+
try {
|
|
177
|
+
this._token = decodeURIComponent(tokenMatch[1]);
|
|
178
|
+
}
|
|
179
|
+
catch (decodeError) {
|
|
180
|
+
throw new Error(`Login failed: unable to decode session token from cookie (${decodeError instanceof Error ? decodeError.message : String(decodeError)})`);
|
|
181
|
+
}
|
|
182
|
+
return response.data.userId;
|
|
183
|
+
}
|
|
184
|
+
/**
|
|
185
|
+
* Logout and destroy the current session.
|
|
186
|
+
* Idempotent - safe to call even if not logged in or if server call fails.
|
|
187
|
+
* Always clears local token regardless of server response.
|
|
188
|
+
*/
|
|
189
|
+
async logout() {
|
|
190
|
+
if (!this._token) {
|
|
191
|
+
return; // Already logged out
|
|
192
|
+
}
|
|
193
|
+
try {
|
|
194
|
+
await sessionDelete({
|
|
195
|
+
client: this._client,
|
|
196
|
+
headers: this.getAuthHeaders(),
|
|
197
|
+
throwOnError: true,
|
|
198
|
+
});
|
|
199
|
+
}
|
|
200
|
+
catch (error) {
|
|
201
|
+
// Log but don't throw - logout should succeed locally even if server call fails
|
|
202
|
+
// Server session may already be expired or invalidated
|
|
203
|
+
try {
|
|
204
|
+
const errorType = error instanceof Error ? error.constructor.name : "Unknown";
|
|
205
|
+
const errorMsg = error instanceof Error ? error.message : String(error);
|
|
206
|
+
process.stderr.write(`Warning: Server logout failed (local token cleared) [${errorType}]: ${errorMsg}\n`);
|
|
207
|
+
}
|
|
208
|
+
catch {
|
|
209
|
+
// Best-effort warning — don't let a broken stderr violate logout's no-throw contract
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
finally {
|
|
213
|
+
this._token = null;
|
|
214
|
+
}
|
|
215
|
+
}
|
|
216
|
+
}
|
|
217
|
+
//# sourceMappingURL=client.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAE5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAQrD,MAAM,OAAO,eAAe;IAClB,OAAO,CAAS;IAChB,QAAQ,CAAS;IACjB,MAAM,GAAkB,IAAI,CAAC;IAErC,YAAY,OAA+B;QACzC,IAAI,CAAC,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,MAAM,GAAuC;YACjD,OAAO,EAAE,GAAG,IAAI,CAAC,QAAQ,SAAS;SACnC,CAAC;QACF,IAAI,OAAO,CAAC,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACnD,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;YAC3B,MAAM,CAAC,KAAK,GAAG,CAAC,KAAwB,EAAE,IAAkB,EAAE,EAAE;gBAC9D,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAC9C,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM;oBACzB,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;oBAC/C,CAAC,CAAC,aAAa,CAAC;gBAClB,OAAO,KAAK,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YAC3C,CAAC,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IACpD,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,cAAc;QACZ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;gBACL,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;gBACtC,MAAM,EAAE,6BAA6B,IAAI,CAAC,MAAM,wCAAwC,IAAI,CAAC,MAAM,EAAE;aACtG,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,gBAAgB,CACpB,QAAgB,EAChB,WAAmB,EACnB,OAGC;QAED,MAAM,MAAM,GAAG,MAAM,4BAA4B,CAAC;YAChD,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ;YACR,WAAW;YACX,GAAG,OAAO;SACX,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC;QAC3B,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,sBAAsB,CAC1B,QAAgB,EAChB,YAAoB,EACpB,OAAkD;QAElD,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC;YAC7C,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ;YACR,YAAY;YACZ,GAAG,OAAO;SACX,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC;QAClC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;IACtE,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,QAAgB;QAC5C,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC;YACnC,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,IAAI,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;YAC5B,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACtE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,uCAAuC;QACvC,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC9D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,4FAA4F,CAC7F,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAChC,4DAA4D,CAC7D,CAAC;QACF,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAC;QACJ,CAAC;QAED,mEAAmE;QACnE,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,WAAW,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,6DAA6D,WAAW,YAAY,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CACzI,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM;QACV,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO,CAAC,qBAAqB;QAC/B,CAAC;QAED,IAAI,CAAC;YACH,MAAM,aAAa,CAAC;gBAClB,MAAM,EAAE,IAAI,CAAC,OAAO;gBACpB,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE;gBAC9B,YAAY,EAAE,IAAI;aACnB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,gFAAgF;YAChF,uDAAuD;YACvD,IAAI,CAAC;gBACH,MAAM,SAAS,GACb,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC9D,MAAM,QAAQ,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACxE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,wDAAwD,SAAS,MAAM,QAAQ,IAAI,CACpF,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,qFAAqF;YACvF,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;IACH,CAAC;CACF"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"config-dir.d.ts","sourceRoot":"","sources":["../src/config-dir.ts"],"names":[],"mappings":"AAGA,mHAAmH;AACnH,wBAAgB,YAAY,IAAI,MAAM,CAOrC"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import { homedir } from "node:os";
|
|
2
|
+
import { isAbsolute, join } from "node:path";
|
|
3
|
+
/** The XDG spec says to ignore a relative XDG_CONFIG_HOME, which would put secrets under the working directory. */
|
|
4
|
+
export function getConfigDir() {
|
|
5
|
+
const xdgConfigHome = process.env.XDG_CONFIG_HOME;
|
|
6
|
+
const base = xdgConfigHome && isAbsolute(xdgConfigHome)
|
|
7
|
+
? xdgConfigHome
|
|
8
|
+
: join(homedir(), ".config");
|
|
9
|
+
return join(base, "perpetual");
|
|
10
|
+
}
|
|
11
|
+
//# sourceMappingURL=config-dir.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"config-dir.js","sourceRoot":"","sources":["../src/config-dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE7C,mHAAmH;AACnH,MAAM,UAAU,YAAY;IAC1B,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAClD,MAAM,IAAI,GACR,aAAa,IAAI,UAAU,CAAC,aAAa,CAAC;QACxC,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IACjC,OAAO,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AACjC,CAAC"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
export interface RegisterClientOptions {
|
|
2
|
+
endpoint: string;
|
|
3
|
+
clientName: string;
|
|
4
|
+
redirectUris: string[];
|
|
5
|
+
/** Defaults to ["authorization_code", "refresh_token"] for interactive CLI clients. */
|
|
6
|
+
grantTypes?: string[];
|
|
7
|
+
/** Defaults to ["code"]. */
|
|
8
|
+
responseTypes?: string[];
|
|
9
|
+
/** Override fetch for testing */
|
|
10
|
+
_fetch?: typeof fetch;
|
|
11
|
+
requestTimeoutMs?: number;
|
|
12
|
+
}
|
|
13
|
+
export interface RegisteredClient {
|
|
14
|
+
clientId: string;
|
|
15
|
+
/** Confidential clients receive a secret; public PKCE-only clients may not. */
|
|
16
|
+
clientSecret?: string;
|
|
17
|
+
redirectUris: string[];
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Register a new OAuth 2.0 client with the authorization server (RFC 7591
|
|
21
|
+
* Dynamic Client Registration). Returns a client_id (and secret if the
|
|
22
|
+
* server issues one) that can be used in subsequent authorization flows.
|
|
23
|
+
*
|
|
24
|
+
* The Perpetual backend issues a client_secret even for public PKCE clients;
|
|
25
|
+
* callers using the authorization-code-pkce flow may ignore the secret.
|
|
26
|
+
*/
|
|
27
|
+
export declare function registerClient(options: RegisterClientOptions): Promise<RegisteredClient>;
|
|
28
|
+
//# sourceMappingURL=dynamic-registration.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dynamic-registration.d.ts","sourceRoot":"","sources":["../src/dynamic-registration.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,4BAA4B;IAC5B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,iCAAiC;IACjC,MAAM,CAAC,EAAE,OAAO,KAAK,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAsE3B"}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import { normalizeEndpoint } from "./token-store.js";
|
|
2
|
+
import { OAUTH_REQUEST_TIMEOUT_MS, oauthHttpError, oauthTransportError, readOAuthBody, } from "./oauth-request-error.js";
|
|
3
|
+
/**
|
|
4
|
+
* Register a new OAuth 2.0 client with the authorization server (RFC 7591
|
|
5
|
+
* Dynamic Client Registration). Returns a client_id (and secret if the
|
|
6
|
+
* server issues one) that can be used in subsequent authorization flows.
|
|
7
|
+
*
|
|
8
|
+
* The Perpetual backend issues a client_secret even for public PKCE clients;
|
|
9
|
+
* callers using the authorization-code-pkce flow may ignore the secret.
|
|
10
|
+
*/
|
|
11
|
+
export async function registerClient(options) {
|
|
12
|
+
const { endpoint, clientName, redirectUris, grantTypes = ["authorization_code", "refresh_token"], responseTypes = ["code"], _fetch: fetchFn = fetch, requestTimeoutMs = OAUTH_REQUEST_TIMEOUT_MS, } = options;
|
|
13
|
+
const url = `${normalizeEndpoint(endpoint)}/api/oauth/register`;
|
|
14
|
+
let response;
|
|
15
|
+
try {
|
|
16
|
+
response = await fetchFn(url, {
|
|
17
|
+
method: "POST",
|
|
18
|
+
headers: { "Content-Type": "application/json" },
|
|
19
|
+
body: JSON.stringify({
|
|
20
|
+
client_name: clientName,
|
|
21
|
+
redirect_uris: redirectUris,
|
|
22
|
+
grant_types: grantTypes,
|
|
23
|
+
response_types: responseTypes,
|
|
24
|
+
}),
|
|
25
|
+
signal: AbortSignal.timeout(requestTimeoutMs),
|
|
26
|
+
});
|
|
27
|
+
}
|
|
28
|
+
catch (networkError) {
|
|
29
|
+
throw oauthTransportError("Dynamic client registration", url, networkError);
|
|
30
|
+
}
|
|
31
|
+
const text = await readOAuthBody("Dynamic client registration", url, response);
|
|
32
|
+
if (!response.ok) {
|
|
33
|
+
throw oauthHttpError("Dynamic client registration", response, text);
|
|
34
|
+
}
|
|
35
|
+
let data;
|
|
36
|
+
try {
|
|
37
|
+
data = JSON.parse(text);
|
|
38
|
+
}
|
|
39
|
+
catch (parseError) {
|
|
40
|
+
const detail = parseError instanceof Error ? parseError.message : String(parseError);
|
|
41
|
+
throw new Error(`Dynamic client registration response is not valid JSON (${response.status}): ${text.slice(0, 200) || response.statusText} (${detail})`);
|
|
42
|
+
}
|
|
43
|
+
if (typeof data.client_id !== "string" || !data.client_id) {
|
|
44
|
+
throw new Error("Dynamic client registration response missing required client_id");
|
|
45
|
+
}
|
|
46
|
+
if (!Array.isArray(data.redirect_uris) ||
|
|
47
|
+
data.redirect_uris.some((u) => typeof u !== "string")) {
|
|
48
|
+
throw new Error("Dynamic client registration response missing valid redirect_uris array");
|
|
49
|
+
}
|
|
50
|
+
return {
|
|
51
|
+
clientId: data.client_id,
|
|
52
|
+
clientSecret: typeof data.client_secret === "string" ? data.client_secret : undefined,
|
|
53
|
+
redirectUris: data.redirect_uris,
|
|
54
|
+
};
|
|
55
|
+
}
|
|
56
|
+
//# sourceMappingURL=dynamic-registration.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dynamic-registration.js","sourceRoot":"","sources":["../src/dynamic-registration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACL,wBAAwB,EACxB,cAAc,EACd,mBAAmB,EACnB,aAAa,GACd,MAAM,0BAA0B,CAAC;AAsBlC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAA8B;IAE9B,MAAM,EACJ,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,UAAU,GAAG,CAAC,oBAAoB,EAAE,eAAe,CAAC,EACpD,aAAa,GAAG,CAAC,MAAM,CAAC,EACxB,MAAM,EAAE,OAAO,GAAG,KAAK,EACvB,gBAAgB,GAAG,wBAAwB,GAC5C,GAAG,OAAO,CAAC;IAEZ,MAAM,GAAG,GAAG,GAAG,iBAAiB,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAChE,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;YAC5B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,WAAW,EAAE,UAAU;gBACvB,aAAa,EAAE,YAAY;gBAC3B,WAAW,EAAE,UAAU;gBACvB,cAAc,EAAE,aAAa;aAC9B,CAAC;YACF,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,gBAAgB,CAAC;SAC9C,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,YAAY,EAAE,CAAC;QACtB,MAAM,mBAAmB,CAAC,6BAA6B,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,aAAa,CAC9B,6BAA6B,EAC7B,GAAG,EACH,QAAQ,CACT,CAAC;IAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,cAAc,CAAC,6BAA6B,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,IAA6B,CAAC;IAClC,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,UAAU,EAAE,CAAC;QACpB,MAAM,MAAM,GACV,UAAU,YAAY,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACxE,MAAM,IAAI,KAAK,CACb,2DAA2D,QAAQ,CAAC,MAAM,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,QAAQ,CAAC,UAAU,KAAK,MAAM,GAAG,CACxI,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CACb,iEAAiE,CAClE,CAAC;IACJ,CAAC;IACD,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC;QAClC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,EACrD,CAAC;QACD,MAAM,IAAI,KAAK,CACb,wEAAwE,CACzE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,SAAS;QACxB,YAAY,EACV,OAAO,IAAI,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;QACzE,YAAY,EAAE,IAAI,CAAC,aAAyB;KAC7C,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.gen.d.ts","sourceRoot":"","sources":["../../../src/generated/client/client.gen.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAA0C,MAAM,gBAAgB,CAAC;AAgB7F,eAAO,MAAM,YAAY,YAAY,MAAM,KAAQ,MA+PlD,CAAC"}
|