@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,3 @@
1
+ // This file is auto-generated by @hey-api/openapi-ts
2
+ export {};
3
+ //# sourceMappingURL=types.gen.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.gen.js","sourceRoot":"","sources":["../../src/generated/types.gen.ts"],"names":[],"mappings":"AAAA,qDAAqD"}
@@ -0,0 +1,21 @@
1
+ export type { AuthorizationCodePkceOptions, AuthorizationCodePkceResult, } from "./authorization-code-pkce.js";
2
+ export { executeAuthorizationCodePkce } from "./authorization-code-pkce.js";
3
+ export type { PerpetualClientOptions } from "./client.js";
4
+ export { PerpetualClient } from "./client.js";
5
+ export type { ClientCredentialsOptions, ClientCredentialsResponse, } from "./client-credentials.js";
6
+ export { exchangeClientCredentials } from "./client-credentials.js";
7
+ export type { RegisteredClientRecord } from "./client-store.js";
8
+ export { clearRegisteredClient, getRegisteredClient, saveRegisteredClient, } from "./client-store.js";
9
+ export type { RegisterClientOptions, RegisteredClient, } from "./dynamic-registration.js";
10
+ export { registerClient } from "./dynamic-registration.js";
11
+ export type { Client } from "./generated/client/index.js";
12
+ export * from "./generated/index.js";
13
+ export { specSource } from "./generated/spec-source.gen.js";
14
+ export type { RefreshTokenGrantOptions, RefreshTokenGrantResult, } from "./refresh-token.js";
15
+ export { executeRefreshTokenGrant } from "./refresh-token.js";
16
+ export type { OAuthRequestFailure } from "./oauth-request-error.js";
17
+ export { OAuthRequestError } from "./oauth-request-error.js";
18
+ export { getConfigDir } from "./config-dir.js";
19
+ export type { StoredToken } from "./token-store.js";
20
+ export { clearAllTokens, clearToken, getStoredToken, normalizeEndpoint, saveToken, } from "./token-store.js";
21
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5E,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,YAAY,EACV,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,YAAY,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAI1D,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAG5D,YAAY,EACV,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,cAAc,EACd,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,SAAS,GACV,MAAM,kBAAkB,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,16 @@
1
+ // Main exports
2
+ export { executeAuthorizationCodePkce } from "./authorization-code-pkce.js";
3
+ export { PerpetualClient } from "./client.js";
4
+ export { exchangeClientCredentials } from "./client-credentials.js";
5
+ export { clearRegisteredClient, getRegisteredClient, saveRegisteredClient, } from "./client-store.js";
6
+ export { registerClient } from "./dynamic-registration.js";
7
+ // Re-export generated types and SDK for direct usage
8
+ // Users can import types like DashboardsListResponses, DashboardsCreateData, etc.
9
+ // and SDK functions like dashboardsList, dashboardsCreate, usersGetCurrent, etc.
10
+ export * from "./generated/index.js";
11
+ export { specSource } from "./generated/spec-source.gen.js";
12
+ export { executeRefreshTokenGrant } from "./refresh-token.js";
13
+ export { OAuthRequestError } from "./oauth-request-error.js";
14
+ export { getConfigDir } from "./config-dir.js";
15
+ export { clearAllTokens, clearToken, getStoredToken, normalizeEndpoint, saveToken, } from "./token-store.js";
16
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AAOf,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAE5E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAM9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAGpE,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D,qDAAqD;AACrD,kFAAkF;AAClF,iFAAiF;AACjF,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAO5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,EACL,cAAc,EACd,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,SAAS,GACV,MAAM,kBAAkB,CAAC"}
@@ -0,0 +1,26 @@
1
+ export type OAuthRequestFailure = "network" | "timeout" | "http";
2
+ /** Matches PerpetualClient's default, so a hung authorization server cannot stall a login forever. */
3
+ export declare const OAUTH_REQUEST_TIMEOUT_MS = 30000;
4
+ /**
5
+ * A request to an OAuth endpoint (token, refresh, registration) that got no
6
+ * usable response. `failure` tells an outage (`network`, `timeout`) apart from
7
+ * an endpoint that answered with an error status (`http`, with `status`).
8
+ */
9
+ export declare class OAuthRequestError extends Error {
10
+ readonly failure: OAuthRequestFailure;
11
+ readonly status?: number;
12
+ constructor(message: string, options: {
13
+ failure: OAuthRequestFailure;
14
+ status?: number;
15
+ cause?: unknown;
16
+ });
17
+ }
18
+ export declare function oauthTransportError(action: string, url: string, cause: unknown): OAuthRequestError;
19
+ export declare function oauthHttpError(action: string, response: Response, body: string): OAuthRequestError;
20
+ /**
21
+ * A success whose body stops arriving is an outage like any other, so it is a
22
+ * transport failure; an error status keeps a placeholder so its status still
23
+ * reaches the caller.
24
+ */
25
+ export declare function readOAuthBody(action: string, url: string, response: Response): Promise<string>;
26
+ //# sourceMappingURL=oauth-request-error.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"oauth-request-error.d.ts","sourceRoot":"","sources":["../src/oauth-request-error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;AAEjE,sGAAsG;AACtG,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAE/C;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB,YACE,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QAAE,OAAO,EAAE,mBAAmB,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAM5E;CACF;AASD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GACb,iBAAiB,CASnB;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,GACX,iBAAiB,CAKnB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,MAAM,CAAC,CAOjB"}
@@ -0,0 +1,47 @@
1
+ /** Matches PerpetualClient's default, so a hung authorization server cannot stall a login forever. */
2
+ export const OAUTH_REQUEST_TIMEOUT_MS = 30_000;
3
+ /**
4
+ * A request to an OAuth endpoint (token, refresh, registration) that got no
5
+ * usable response. `failure` tells an outage (`network`, `timeout`) apart from
6
+ * an endpoint that answered with an error status (`http`, with `status`).
7
+ */
8
+ export class OAuthRequestError extends Error {
9
+ failure;
10
+ status;
11
+ constructor(message, options) {
12
+ super(message, { cause: options.cause });
13
+ this.name = "OAuthRequestError";
14
+ this.failure = options.failure;
15
+ this.status = options.status;
16
+ }
17
+ }
18
+ function isTimeout(error) {
19
+ return (error instanceof Error &&
20
+ (error.name === "TimeoutError" || error.name === "AbortError"));
21
+ }
22
+ export function oauthTransportError(action, url, cause) {
23
+ const detail = cause instanceof Error ? cause.message : String(cause);
24
+ const timedOut = isTimeout(cause);
25
+ return new OAuthRequestError(timedOut
26
+ ? `${action} failed: timed out waiting for ${url}`
27
+ : `${action} failed: network error at ${url}: ${detail}`, { failure: timedOut ? "timeout" : "network", cause });
28
+ }
29
+ export function oauthHttpError(action, response, body) {
30
+ return new OAuthRequestError(`${action} failed (${response.status}): ${body || response.statusText}`, { failure: "http", status: response.status });
31
+ }
32
+ /**
33
+ * A success whose body stops arriving is an outage like any other, so it is a
34
+ * transport failure; an error status keeps a placeholder so its status still
35
+ * reaches the caller.
36
+ */
37
+ export async function readOAuthBody(action, url, response) {
38
+ try {
39
+ return await response.text();
40
+ }
41
+ catch (e) {
42
+ if (response.ok)
43
+ throw oauthTransportError(action, url, e);
44
+ return `(error body unreadable: ${e instanceof Error ? e.message : String(e)})`;
45
+ }
46
+ }
47
+ //# sourceMappingURL=oauth-request-error.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"oauth-request-error.js","sourceRoot":"","sources":["../src/oauth-request-error.ts"],"names":[],"mappings":"AAEA,sGAAsG;AACtG,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAE/C;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,OAAO,CAAsB;IAC7B,MAAM,CAAU;IAEzB,YACE,OAAe,EACf,OAA2E;QAE3E,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/B,CAAC;CACF;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,CACL,KAAK,YAAY,KAAK;QACtB,CAAC,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,CAC/D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAc,EACd,GAAW,EACX,KAAc;IAEd,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO,IAAI,iBAAiB,CAC1B,QAAQ;QACN,CAAC,CAAC,GAAG,MAAM,kCAAkC,GAAG,EAAE;QAClD,CAAC,CAAC,GAAG,MAAM,6BAA6B,GAAG,KAAK,MAAM,EAAE,EAC1D,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,CACrD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,QAAkB,EAClB,IAAY;IAEZ,OAAO,IAAI,iBAAiB,CAC1B,GAAG,MAAM,YAAY,QAAQ,CAAC,MAAM,MAAM,IAAI,IAAI,QAAQ,CAAC,UAAU,EAAE,EACvE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAC7C,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,EACd,GAAW,EACX,QAAkB;IAElB,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,QAAQ,CAAC,EAAE;YAAE,MAAM,mBAAmB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAC3D,OAAO,2BAA2B,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;IAClF,CAAC;AACH,CAAC"}
@@ -0,0 +1,50 @@
1
+ export interface RefreshTokenGrantOptions {
2
+ endpoint: string;
3
+ /** OAuth client_id from dynamic registration. Public clients still send
4
+ * client_id on refresh; confidential clients also send client_secret. */
5
+ clientId: string;
6
+ /** Optional client_secret. Mirrors authorization-code-pkce.ts: PKCE-only
7
+ * flows can omit it, but the Perpetual backend may issue a secret on
8
+ * registration which must be included here. */
9
+ clientSecret?: string;
10
+ /** The refresh token to exchange. Per OAuth 2.1 §6, the AS may rotate
11
+ * this on every use — the response's refresh_token field MUST be saved
12
+ * back if present. */
13
+ refreshToken: string;
14
+ /** Override fetch for testing. */
15
+ _fetch?: typeof fetch;
16
+ /** Where to write user-facing progress messages (defaults to no-op,
17
+ * since refresh is silent). */
18
+ log?: (message: string) => void;
19
+ requestTimeoutMs?: number;
20
+ }
21
+ export interface RefreshTokenGrantResult {
22
+ token: string;
23
+ /** New refresh token if the AS rotated it. Per OAuth 2.1 §6.1 rotation
24
+ * is recommended for public clients; if the response omits it, the
25
+ * caller should keep using the previous refresh token (older AS
26
+ * implementations don't rotate). */
27
+ refreshToken?: string;
28
+ expiresIn?: number;
29
+ tokenType: string;
30
+ }
31
+ /**
32
+ * Exchange a refresh token for a fresh access token.
33
+ *
34
+ * Implements RFC 6749 §6 (Refreshing an Access Token) against the
35
+ * Perpetual `/api/oauth/token` endpoint. Mirrors the response-parsing
36
+ * shape of `executeAuthorizationCodePkce` so callers can handle both
37
+ * grant types uniformly.
38
+ *
39
+ * Throws on:
40
+ * - Network errors (transport-level failures hitting the token endpoint)
41
+ * - Non-2xx responses (refresh token expired/invalid/revoked)
42
+ * - Malformed response (missing access_token, non-Bearer token_type)
43
+ *
44
+ * The CLI's refreshStoredLogin catches these and surfaces a
45
+ * "Run perpetual login to re-authenticate" message — most failures here
46
+ * mean the refresh token is no longer valid and the user must re-auth
47
+ * via the browser flow.
48
+ */
49
+ export declare function executeRefreshTokenGrant(options: RefreshTokenGrantOptions): Promise<RefreshTokenGrantResult>;
50
+ //# sourceMappingURL=refresh-token.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"refresh-token.d.ts","sourceRoot":"","sources":["../src/refresh-token.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB;8EAC0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB;;oDAEgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;2BAEuB;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,MAAM,CAAC,EAAE,OAAO,KAAK,CAAC;IACtB;oCACgC;IAChC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd;;;yCAGqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CAiFlC"}
@@ -0,0 +1,83 @@
1
+ import { normalizeEndpoint } from "./token-store.js";
2
+ import { OAUTH_REQUEST_TIMEOUT_MS, oauthHttpError, oauthTransportError, readOAuthBody, } from "./oauth-request-error.js";
3
+ /**
4
+ * Exchange a refresh token for a fresh access token.
5
+ *
6
+ * Implements RFC 6749 §6 (Refreshing an Access Token) against the
7
+ * Perpetual `/api/oauth/token` endpoint. Mirrors the response-parsing
8
+ * shape of `executeAuthorizationCodePkce` so callers can handle both
9
+ * grant types uniformly.
10
+ *
11
+ * Throws on:
12
+ * - Network errors (transport-level failures hitting the token endpoint)
13
+ * - Non-2xx responses (refresh token expired/invalid/revoked)
14
+ * - Malformed response (missing access_token, non-Bearer token_type)
15
+ *
16
+ * The CLI's refreshStoredLogin catches these and surfaces a
17
+ * "Run perpetual login to re-authenticate" message — most failures here
18
+ * mean the refresh token is no longer valid and the user must re-auth
19
+ * via the browser flow.
20
+ */
21
+ export async function executeRefreshTokenGrant(options) {
22
+ const fetchFn = options._fetch ?? fetch;
23
+ const requestTimeoutMs = options.requestTimeoutMs ?? OAUTH_REQUEST_TIMEOUT_MS;
24
+ const log = options.log ?? (() => { });
25
+ const tokenUrl = `${normalizeEndpoint(options.endpoint)}/api/oauth/token`;
26
+ const body = new URLSearchParams({
27
+ grant_type: "refresh_token",
28
+ refresh_token: options.refreshToken,
29
+ client_id: options.clientId,
30
+ });
31
+ if (options.clientSecret) {
32
+ body.set("client_secret", options.clientSecret);
33
+ }
34
+ let response;
35
+ try {
36
+ response = await fetchFn(tokenUrl, {
37
+ method: "POST",
38
+ headers: { "Content-Type": "application/x-www-form-urlencoded" },
39
+ body: body.toString(),
40
+ signal: AbortSignal.timeout(requestTimeoutMs),
41
+ });
42
+ }
43
+ catch (networkError) {
44
+ throw oauthTransportError("Refresh token exchange", tokenUrl, networkError);
45
+ }
46
+ const text = await readOAuthBody("Refresh token exchange", tokenUrl, response);
47
+ if (!response.ok) {
48
+ throw oauthHttpError("Refresh token exchange", response, text);
49
+ }
50
+ let data;
51
+ try {
52
+ data = JSON.parse(text);
53
+ }
54
+ catch (parseError) {
55
+ const detail = parseError instanceof Error ? parseError.message : String(parseError);
56
+ throw new Error(`Refresh token response is not valid JSON (${response.status}): ${text.slice(0, 200) || response.statusText} (${detail})`);
57
+ }
58
+ if (typeof data.access_token !== "string" || !data.access_token) {
59
+ throw new Error("Refresh token response missing access_token");
60
+ }
61
+ const tokenType = typeof data.token_type === "string" ? data.token_type : "Bearer";
62
+ if (tokenType.toLowerCase() !== "bearer") {
63
+ throw new Error(`Unsupported token type: "${tokenType}". Only Bearer tokens are supported.`);
64
+ }
65
+ let expiresIn;
66
+ if (data.expires_in !== undefined) {
67
+ if (typeof data.expires_in === "number" &&
68
+ Number.isFinite(data.expires_in) &&
69
+ data.expires_in > 0) {
70
+ expiresIn = data.expires_in;
71
+ }
72
+ else {
73
+ log(`Warning: refresh response contained invalid expires_in: ${JSON.stringify(data.expires_in)}, ignoring\n`);
74
+ }
75
+ }
76
+ return {
77
+ token: data.access_token,
78
+ refreshToken: typeof data.refresh_token === "string" ? data.refresh_token : undefined,
79
+ expiresIn,
80
+ tokenType,
81
+ };
82
+ }
83
+ //# sourceMappingURL=refresh-token.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"refresh-token.js","sourceRoot":"","sources":["../src/refresh-token.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,38 @@
1
+ export interface StoredToken {
2
+ token: string;
3
+ expiresAt?: string;
4
+ userId?: string;
5
+ orgId?: string;
6
+ }
7
+ /**
8
+ * Normalize an endpoint URL for use as a token store key.
9
+ * Strips trailing slashes and lowercases the host portion.
10
+ */
11
+ export declare function normalizeEndpoint(endpoint: string): string;
12
+ /**
13
+ * Retrieve a stored token for the given endpoint (and optional clientId).
14
+ * Returns null if no token is found, the token is expired (or within 60s of expiry),
15
+ * or the file has invalid JSON.
16
+ * Throws if the file cannot be read due to filesystem errors (permissions, I/O).
17
+ */
18
+ export declare function getStoredToken(endpoint: string, clientId?: string): StoredToken | null;
19
+ /**
20
+ * Save a token for the given endpoint (and optional clientId).
21
+ */
22
+ export declare function saveToken(endpoint: string, token: string, options?: {
23
+ clientId?: string;
24
+ userId?: string;
25
+ orgId?: string;
26
+ expiresAt?: string;
27
+ }): void;
28
+ /**
29
+ * Clear the stored token for a specific endpoint (and optional clientId).
30
+ * May throw if the token file cannot be read or written (filesystem errors).
31
+ */
32
+ export declare function clearToken(endpoint: string, clientId?: string): void;
33
+ /**
34
+ * Clear all stored tokens.
35
+ * May throw if the token file cannot be written (filesystem errors).
36
+ */
37
+ export declare function clearAllTokens(): void;
38
+ //# sourceMappingURL=token-store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"token-store.d.ts","sourceRoot":"","sources":["../src/token-store.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAoB1D;AA4HD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,WAAW,GAAG,IAAI,CAkBpB;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,IAAI,CAmBN;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAKpE;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC"}
@@ -0,0 +1,195 @@
1
+ import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from "node:fs";
2
+ import { dirname, join } from "node:path";
3
+ import { getConfigDir } from "./config-dir.js";
4
+ /**
5
+ * Normalize an endpoint URL for use as a token store key.
6
+ * Strips trailing slashes and lowercases the host portion.
7
+ */
8
+ export function normalizeEndpoint(endpoint) {
9
+ try {
10
+ const url = new URL(endpoint);
11
+ url.hostname = url.hostname.toLowerCase();
12
+ // Remove trailing slash from pathname
13
+ if (url.pathname.endsWith("/")) {
14
+ url.pathname = url.pathname.replace(/\/+$/, "") || "/";
15
+ }
16
+ // Return origin + pathname (without trailing slash), dropping default port
17
+ let result = url.origin;
18
+ if (url.pathname !== "/") {
19
+ result += url.pathname;
20
+ }
21
+ return result;
22
+ }
23
+ catch (parseError) {
24
+ throw new Error(`Invalid endpoint URL: "${endpoint}". Must include protocol (e.g., https://example.com). ` +
25
+ `Parse error: ${parseError instanceof Error ? parseError.message : String(parseError)}`);
26
+ }
27
+ }
28
+ /**
29
+ * Build a composite key for the token store.
30
+ * When clientId is provided, the key is `endpoint::clientId` to support
31
+ * multiple OAuth clients on the same endpoint.
32
+ */
33
+ function tokenKey(endpoint, clientId) {
34
+ const normalized = normalizeEndpoint(endpoint);
35
+ return clientId ? `${normalized}::${clientId}` : normalized;
36
+ }
37
+ function getTokenFilePath() {
38
+ return join(getConfigDir(), "tokens.json");
39
+ }
40
+ /**
41
+ * Back up a corrupted token file so data is not permanently lost.
42
+ * Best-effort: logs a warning if the backup itself fails.
43
+ */
44
+ function backupCorruptedFile(filePath) {
45
+ const backupPath = `${filePath}.bak`;
46
+ try {
47
+ copyFileSync(filePath, backupPath);
48
+ process.stderr.write(` Corrupted file backed up to ${backupPath}\n`);
49
+ }
50
+ catch (backupError) {
51
+ process.stderr.write(` Warning: Could not back up corrupted file: ${backupError instanceof Error ? backupError.message : String(backupError)}\n`);
52
+ }
53
+ }
54
+ function readTokenFile() {
55
+ const filePath = getTokenFilePath();
56
+ if (!existsSync(filePath)) {
57
+ return {};
58
+ }
59
+ let content;
60
+ try {
61
+ content = readFileSync(filePath, "utf-8");
62
+ }
63
+ catch (fsError) {
64
+ // Filesystem errors (permissions, I/O) — propagate so callers know
65
+ throw new Error(`Cannot read tokens.json: ${fsError instanceof Error ? fsError.message : String(fsError)}`);
66
+ }
67
+ let parsed;
68
+ try {
69
+ parsed = JSON.parse(content);
70
+ }
71
+ catch (parseError) {
72
+ const detail = parseError instanceof Error ? parseError.message : String(parseError);
73
+ backupCorruptedFile(filePath);
74
+ process.stderr.write(`Warning: tokens.json contains invalid JSON (${detail}), starting fresh\n`);
75
+ return {};
76
+ }
77
+ if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
78
+ backupCorruptedFile(filePath);
79
+ process.stderr.write("Warning: tokens.json has unexpected format, ignoring\n");
80
+ return {};
81
+ }
82
+ return parsed;
83
+ }
84
+ function writeTokenFile(data) {
85
+ const filePath = getTokenFilePath();
86
+ const dir = dirname(filePath);
87
+ const tmpPath = `${filePath}.tmp`;
88
+ // Atomic write: stage to <path>.tmp, chmod, then rename into place.
89
+ // POSIX rename is atomic, so a process kill mid-write cannot leave a
90
+ // half-written file that would silently lose every stored token on next
91
+ // read. Mirrors the pattern used in client-store.ts.
92
+ try {
93
+ if (!existsSync(dir)) {
94
+ mkdirSync(dir, { recursive: true, mode: 0o700 });
95
+ }
96
+ writeFileSync(tmpPath, JSON.stringify(data, null, 2), { mode: 0o600 });
97
+ try {
98
+ // writeFileSync's `mode` is only honored when CREATING the file, so
99
+ // chmod after-the-fact when the staging path already existed.
100
+ // Chmod failures matter on a credentials file: surface them so a
101
+ // mis-umask'd write doesn't leave the secret world-readable silently.
102
+ chmodSync(tmpPath, 0o600);
103
+ }
104
+ catch (e) {
105
+ process.stderr.write(`Warning: could not chmod ${tmpPath} to 0600: ` +
106
+ `${e instanceof Error ? e.message : String(e)}\n`);
107
+ }
108
+ renameSync(tmpPath, filePath);
109
+ try {
110
+ chmodSync(dir, 0o700);
111
+ }
112
+ catch (e) {
113
+ process.stderr.write(`Warning: could not chmod ${dir} to 0700: ` +
114
+ `${e instanceof Error ? e.message : String(e)}\n`);
115
+ }
116
+ }
117
+ catch (fsError) {
118
+ // Clean up the staging file on failure so a transient I/O error
119
+ // doesn't leave a stray credentials .tmp around forever.
120
+ try {
121
+ if (existsSync(tmpPath))
122
+ unlinkSync(tmpPath);
123
+ }
124
+ catch {
125
+ /* best effort */
126
+ }
127
+ throw new Error(`Failed to write token file at ${filePath}: ${fsError instanceof Error ? fsError.message : String(fsError)}`);
128
+ }
129
+ }
130
+ /** Buffer before token expiry to avoid using almost-expired tokens (60 seconds). */
131
+ const EXPIRY_BUFFER_MS = 60 * 1000;
132
+ /**
133
+ * Retrieve a stored token for the given endpoint (and optional clientId).
134
+ * Returns null if no token is found, the token is expired (or within 60s of expiry),
135
+ * or the file has invalid JSON.
136
+ * Throws if the file cannot be read due to filesystem errors (permissions, I/O).
137
+ */
138
+ export function getStoredToken(endpoint, clientId) {
139
+ const key = tokenKey(endpoint, clientId);
140
+ const tokens = readTokenFile();
141
+ const stored = tokens[key];
142
+ if (!stored?.token) {
143
+ return null;
144
+ }
145
+ // Check expiry if present (with buffer to avoid using almost-expired tokens)
146
+ if (stored.expiresAt) {
147
+ const expiry = new Date(stored.expiresAt);
148
+ if (Number.isNaN(expiry.getTime()) ||
149
+ expiry.getTime() <= Date.now() + EXPIRY_BUFFER_MS) {
150
+ return null;
151
+ }
152
+ }
153
+ return stored;
154
+ }
155
+ /**
156
+ * Save a token for the given endpoint (and optional clientId).
157
+ */
158
+ export function saveToken(endpoint, token, options) {
159
+ if (!token) {
160
+ throw new Error("Cannot save empty token");
161
+ }
162
+ if (options?.expiresAt) {
163
+ const expiry = new Date(options.expiresAt);
164
+ if (Number.isNaN(expiry.getTime())) {
165
+ throw new Error(`Invalid expiresAt date: ${options.expiresAt}`);
166
+ }
167
+ }
168
+ const key = tokenKey(endpoint, options?.clientId);
169
+ const tokens = readTokenFile();
170
+ tokens[key] = {
171
+ token,
172
+ ...(options?.expiresAt ? { expiresAt: options.expiresAt } : {}),
173
+ ...(options?.userId ? { userId: options.userId } : {}),
174
+ ...(options?.orgId ? { orgId: options.orgId } : {}),
175
+ };
176
+ writeTokenFile(tokens);
177
+ }
178
+ /**
179
+ * Clear the stored token for a specific endpoint (and optional clientId).
180
+ * May throw if the token file cannot be read or written (filesystem errors).
181
+ */
182
+ export function clearToken(endpoint, clientId) {
183
+ const key = tokenKey(endpoint, clientId);
184
+ const tokens = readTokenFile();
185
+ delete tokens[key];
186
+ writeTokenFile(tokens);
187
+ }
188
+ /**
189
+ * Clear all stored tokens.
190
+ * May throw if the token file cannot be written (filesystem errors).
191
+ */
192
+ export function clearAllTokens() {
193
+ writeTokenFile({});
194
+ }
195
+ //# sourceMappingURL=token-store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"token-store.js","sourceRoot":"","sources":["../src/token-store.ts"],"names":[],"mappings":"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"}