@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.
Files changed (157) hide show
  1. package/README.md +26 -1
  2. package/dist/authorization-code-pkce.d.ts +40 -0
  3. package/dist/authorization-code-pkce.d.ts.map +1 -0
  4. package/dist/authorization-code-pkce.js +272 -0
  5. package/dist/authorization-code-pkce.js.map +1 -0
  6. package/dist/client-credentials.d.ts +18 -0
  7. package/dist/client-credentials.d.ts.map +1 -0
  8. package/dist/client-credentials.js +79 -0
  9. package/dist/client-credentials.js.map +1 -0
  10. package/dist/client-store.d.ts +37 -0
  11. package/dist/client-store.d.ts.map +1 -0
  12. package/dist/client-store.js +138 -0
  13. package/dist/client-store.js.map +1 -0
  14. package/dist/client.d.ts +113 -0
  15. package/dist/client.d.ts.map +1 -0
  16. package/dist/client.js +217 -0
  17. package/dist/client.js.map +1 -0
  18. package/dist/config-dir.d.ts +3 -0
  19. package/dist/config-dir.d.ts.map +1 -0
  20. package/dist/config-dir.js +11 -0
  21. package/dist/config-dir.js.map +1 -0
  22. package/dist/dynamic-registration.d.ts +28 -0
  23. package/dist/dynamic-registration.d.ts.map +1 -0
  24. package/dist/dynamic-registration.js +56 -0
  25. package/dist/dynamic-registration.js.map +1 -0
  26. package/dist/generated/client/client.gen.d.ts +3 -0
  27. package/dist/generated/client/client.gen.d.ts.map +1 -0
  28. package/dist/generated/client/client.gen.js +217 -0
  29. package/dist/generated/client/client.gen.js.map +1 -0
  30. package/dist/generated/client/index.d.ts +11 -0
  31. package/dist/generated/client/index.d.ts.map +1 -0
  32. package/dist/generated/client/index.js +7 -0
  33. package/dist/generated/client/index.js.map +1 -0
  34. package/dist/generated/client/types.gen.d.ts +121 -0
  35. package/dist/generated/client/types.gen.d.ts.map +1 -0
  36. package/dist/generated/client/types.gen.js +3 -0
  37. package/dist/generated/client/types.gen.js.map +1 -0
  38. package/dist/generated/client/utils.gen.d.ts +38 -0
  39. package/dist/generated/client/utils.gen.d.ts.map +1 -0
  40. package/dist/generated/client/utils.gen.js +229 -0
  41. package/dist/generated/client/utils.gen.js.map +1 -0
  42. package/dist/generated/client.gen.d.ts +13 -0
  43. package/dist/generated/client.gen.d.ts.map +1 -0
  44. package/dist/generated/client.gen.js +4 -0
  45. package/dist/generated/client.gen.js.map +1 -0
  46. package/dist/generated/core/auth.gen.d.ts +26 -0
  47. package/dist/generated/core/auth.gen.d.ts.map +1 -0
  48. package/dist/generated/core/auth.gen.js +15 -0
  49. package/dist/generated/core/auth.gen.js.map +1 -0
  50. package/dist/generated/core/bodySerializer.gen.d.ts +26 -0
  51. package/dist/generated/core/bodySerializer.gen.d.ts.map +1 -0
  52. package/dist/generated/core/bodySerializer.gen.js +58 -0
  53. package/dist/generated/core/bodySerializer.gen.js.map +1 -0
  54. package/dist/generated/core/params.gen.d.ts +44 -0
  55. package/dist/generated/core/params.gen.d.ts.map +1 -0
  56. package/dist/generated/core/params.gen.js +110 -0
  57. package/dist/generated/core/params.gen.js.map +1 -0
  58. package/dist/generated/core/pathSerializer.gen.d.ts +34 -0
  59. package/dist/generated/core/pathSerializer.gen.d.ts.map +1 -0
  60. package/dist/generated/core/pathSerializer.gen.js +107 -0
  61. package/dist/generated/core/pathSerializer.gen.js.map +1 -0
  62. package/dist/generated/core/queryKeySerializer.gen.d.ts +19 -0
  63. package/dist/generated/core/queryKeySerializer.gen.d.ts.map +1 -0
  64. package/dist/generated/core/queryKeySerializer.gen.js +93 -0
  65. package/dist/generated/core/queryKeySerializer.gen.js.map +1 -0
  66. package/dist/generated/core/serverSentEvents.gen.d.ts +72 -0
  67. package/dist/generated/core/serverSentEvents.gen.d.ts.map +1 -0
  68. package/dist/generated/core/serverSentEvents.gen.js +133 -0
  69. package/dist/generated/core/serverSentEvents.gen.js.map +1 -0
  70. package/dist/generated/core/types.gen.d.ts +84 -0
  71. package/dist/generated/core/types.gen.d.ts.map +1 -0
  72. package/dist/generated/core/types.gen.js +3 -0
  73. package/dist/generated/core/types.gen.js.map +1 -0
  74. package/dist/generated/core/utils.gen.d.ts +20 -0
  75. package/dist/generated/core/utils.gen.d.ts.map +1 -0
  76. package/dist/generated/core/utils.gen.js +88 -0
  77. package/dist/generated/core/utils.gen.js.map +1 -0
  78. package/dist/generated/enum-values.gen.d.ts +331 -0
  79. package/dist/generated/enum-values.gen.d.ts.map +1 -0
  80. package/dist/generated/enum-values.gen.js +332 -0
  81. package/dist/generated/enum-values.gen.js.map +1 -0
  82. package/dist/generated/file-schemas.gen.d.ts +14 -0
  83. package/dist/generated/file-schemas.gen.d.ts.map +1 -0
  84. package/dist/generated/file-schemas.gen.js +3786 -0
  85. package/dist/generated/file-schemas.gen.js.map +1 -0
  86. package/dist/generated/index.d.ts +3 -0
  87. package/dist/generated/index.d.ts.map +1 -0
  88. package/dist/generated/index.js +3 -0
  89. package/dist/generated/index.js.map +1 -0
  90. package/dist/generated/sdk.gen.d.ts +1713 -0
  91. package/dist/generated/sdk.gen.d.ts.map +1 -0
  92. package/dist/generated/sdk.gen.js +10574 -0
  93. package/dist/generated/sdk.gen.js.map +1 -0
  94. package/dist/generated/spec-source.gen.d.ts +8 -0
  95. package/dist/generated/spec-source.gen.d.ts.map +1 -0
  96. package/dist/generated/spec-source.gen.js +9 -0
  97. package/dist/generated/spec-source.gen.js.map +1 -0
  98. package/dist/generated/types.gen.d.ts +30382 -0
  99. package/dist/generated/types.gen.d.ts.map +1 -0
  100. package/dist/generated/types.gen.js +3 -0
  101. package/dist/generated/types.gen.js.map +1 -0
  102. package/dist/index.d.ts +21 -0
  103. package/dist/index.d.ts.map +1 -0
  104. package/dist/index.js +16 -0
  105. package/dist/index.js.map +1 -0
  106. package/dist/oauth-request-error.d.ts +26 -0
  107. package/dist/oauth-request-error.d.ts.map +1 -0
  108. package/dist/oauth-request-error.js +47 -0
  109. package/dist/oauth-request-error.js.map +1 -0
  110. package/dist/refresh-token.d.ts +50 -0
  111. package/dist/refresh-token.d.ts.map +1 -0
  112. package/dist/refresh-token.js +83 -0
  113. package/dist/refresh-token.js.map +1 -0
  114. package/dist/token-store.d.ts +38 -0
  115. package/dist/token-store.d.ts.map +1 -0
  116. package/dist/token-store.js +195 -0
  117. package/dist/token-store.js.map +1 -0
  118. package/openapi/openapi.json +128387 -0
  119. package/package.json +66 -4
  120. package/src/__tests__/authorization-code-pkce.test.ts +245 -0
  121. package/src/__tests__/client-credentials.test.ts +360 -0
  122. package/src/__tests__/client-store.test.ts +139 -0
  123. package/src/__tests__/client.test.ts +529 -0
  124. package/src/__tests__/config-dir.test.ts +22 -0
  125. package/src/__tests__/dynamic-registration.test.ts +181 -0
  126. package/src/__tests__/oauth-request-error.test.ts +148 -0
  127. package/src/__tests__/refresh-token.test.ts +206 -0
  128. package/src/__tests__/token-store.test.ts +449 -0
  129. package/src/authorization-code-pkce.ts +417 -0
  130. package/src/client-credentials.ts +127 -0
  131. package/src/client-store.ts +182 -0
  132. package/src/client.ts +261 -0
  133. package/src/config-dir.ts +12 -0
  134. package/src/dynamic-registration.ts +109 -0
  135. package/src/generated/client/client.gen.ts +277 -0
  136. package/src/generated/client/index.ts +27 -0
  137. package/src/generated/client/types.gen.ts +218 -0
  138. package/src/generated/client/utils.gen.ts +316 -0
  139. package/src/generated/client.gen.ts +16 -0
  140. package/src/generated/core/auth.gen.ts +48 -0
  141. package/src/generated/core/bodySerializer.gen.ts +82 -0
  142. package/src/generated/core/params.gen.ts +178 -0
  143. package/src/generated/core/pathSerializer.gen.ts +171 -0
  144. package/src/generated/core/queryKeySerializer.gen.ts +117 -0
  145. package/src/generated/core/serverSentEvents.gen.ts +242 -0
  146. package/src/generated/core/types.gen.ts +110 -0
  147. package/src/generated/core/utils.gen.ts +140 -0
  148. package/src/generated/enum-values.gen.ts +332 -0
  149. package/src/generated/file-schemas.gen.ts +3800 -0
  150. package/src/generated/index.ts +4 -0
  151. package/src/generated/sdk.gen.ts +10992 -0
  152. package/src/generated/spec-source.gen.ts +9 -0
  153. package/src/generated/types.gen.ts +32415 -0
  154. package/src/index.ts +55 -0
  155. package/src/oauth-request-error.ts +75 -0
  156. package/src/refresh-token.ts +142 -0
  157. 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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"}
@@ -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,3 @@
1
+ /** The XDG spec says to ignore a relative XDG_CONFIG_HOME, which would put secrets under the working directory. */
2
+ export declare function getConfigDir(): string;
3
+ //# sourceMappingURL=config-dir.d.ts.map
@@ -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,3 @@
1
+ import type { Client, Config } from './types.gen.js';
2
+ export declare const createClient: (config?: Config) => Client;
3
+ //# sourceMappingURL=client.gen.d.ts.map
@@ -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"}