@dbx-tools/auth 0.9.99 → 0.9.106

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 CHANGED
@@ -6,8 +6,18 @@ Node.js and Bun.
6
6
  The package resolves profile configuration, selects PAT, M2M, CLI U2M, App
7
7
  service-principal, or App OBO authentication, and coordinates token acquisition
8
8
  in process memory. Generated Python bindings can also accept authentication from
9
- the shared Python runtime. The Node package does not own workspace HTTP APIs or
10
- construct Databricks SDK clients.
9
+ the shared Python runtime. Use the returned host, token, or headers with the
10
+ workspace client for the capability being called.
11
+
12
+ ## Quick Start
13
+
14
+ ```ts
15
+ import { client } from "@dbx-tools/auth";
16
+
17
+ const auth = await client.createAuthClient({ profile: "DEFAULT" });
18
+ const headers = await auth.headers();
19
+ await fetch(`${auth.host}/api/2.0/clusters/list`, { headers });
20
+ ```
11
21
 
12
22
  ## Features
13
23
 
@@ -25,7 +35,7 @@ CLI-backed U2M requires an available `databricks` executable or an explicit
25
35
  `DATABRICKS_CLI_PATH`. The Databricks CLI remains responsible for its own login
26
36
  and credential persistence.
27
37
 
28
- ## Basic use
38
+ ## Client API
29
39
 
30
40
  ```ts
31
41
  import { client, profile } from "@dbx-tools/auth";
@@ -51,28 +61,27 @@ Browser and UI code should import auth-type values, target values, profile
51
61
  summaries, profile selections, and client-configuration schemas from
52
62
  `@dbx-tools/shared-auth`.
53
63
 
54
- ## Consumer-owned clients
64
+ ## Use The Credentials In A Client
55
65
 
56
- Capability packages should use the returned `AuthClient` directly:
66
+ Use the returned `AuthClient` directly:
57
67
 
58
68
  ```ts
59
69
  const auth = await client.createAuthClient({ profile: "DEFAULT" });
60
70
  const headers = await auth.headers();
61
71
  ```
62
72
 
63
- Use those headers in a capability-specific request, or inject the token and host
64
- into an AppKit or Databricks SDK workspace client. Keep request paths, payloads,
65
- response parsing, and retry policy in the consuming package.
73
+ Use the headers in an HTTP request, or inject the token and host into an AppKit
74
+ or Databricks SDK workspace client.
66
75
 
67
76
  ## Public modules
68
77
 
69
- - `client` owns `createAuthClient`, `AuthClient`, access-token results, and
78
+ - `client` exports `createAuthClient`, `AuthClient`, access-token results, and
70
79
  token lifecycle operations.
71
- - `config` owns secret-bearing profile options, lifecycle timing, and canonical
80
+ - `config` exports secret-bearing profile options, lifecycle timing, and canonical
72
81
  header names.
73
- - `profile` owns profile resolution and listing operations.
82
+ - `profile` exports profile resolution and listing operations.
74
83
 
75
- Provider, lifecycle, lock, and storage types are private implementation details.
84
+ Provider, lock, and token-storage internals are not part of the public API.
76
85
 
77
86
  ## Debug logging
78
87
 
package/index.ts CHANGED
@@ -3,7 +3,7 @@
3
3
  // Hand edits are overwritten on the next watch; this file is read-only.
4
4
 
5
5
  export const PACKAGE_IDENTIFIER = "@dbx-tools/auth";
6
- export const PACKAGE_VERSION = "0.9.99";
6
+ export const PACKAGE_VERSION = "0.9.106";
7
7
  export * as bindings from "./src/bindings.ts";
8
8
  export * as client from "./src/client.ts";
9
9
  export * as config from "./src/config.ts";
package/lib/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  export declare const PACKAGE_IDENTIFIER = "@dbx-tools/auth";
2
- export declare const PACKAGE_VERSION = "0.9.99";
2
+ export declare const PACKAGE_VERSION = "0.9.106";
3
3
  export * as bindings from "./src/bindings.ts";
4
4
  export * as client from "./src/client.ts";
5
5
  export * as config from "./src/config.ts";
package/lib/index.js CHANGED
@@ -2,11 +2,11 @@
2
2
  // Regenerated from the exporting modules in ./src.
3
3
  // Hand edits are overwritten on the next watch; this file is read-only.
4
4
  export const PACKAGE_IDENTIFIER = "@dbx-tools/auth";
5
- export const PACKAGE_VERSION = "0.9.99";
5
+ export const PACKAGE_VERSION = "0.9.106";
6
6
  export * as bindings from "./src/bindings.js";
7
7
  export * as client from "./src/client.js";
8
8
  export * as config from "./src/config.js";
9
9
  export * as profile from "./src/profile.js";
10
10
  export * as runtimeAuth from "./src/runtime-auth.js";
11
11
  export { AuthOptionsSchema, DatabricksAuthOptionsSchema, AUTH_DEFAULTS, DEFAULT_CLIENT_ID, DEFAULT_CONFIG_FILE, DEFAULT_ACCESS_TOKEN_HEADER, WORKSPACE_ID_HEADER } from "./src/config.js";
12
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSwyQ0FBMkM7QUFDM0MsbURBQW1EO0FBQ25ELHdFQUF3RTtBQUV4RSxNQUFNLENBQUMsTUFBTSxrQkFBa0IsR0FBRyxpQkFBaUIsQ0FBQztBQUNwRCxNQUFNLENBQUMsTUFBTSxlQUFlLEdBQUcsUUFBUSxDQUFDO0FBQ3hDLE9BQU8sS0FBSyxRQUFRLE1BQU0sbUJBQW1CLENBQUM7QUFDOUMsT0FBTyxLQUFLLE1BQU0sTUFBTSxpQkFBaUIsQ0FBQztBQUMxQyxPQUFPLEtBQUssTUFBTSxNQUFNLGlCQUFpQixDQUFDO0FBQzFDLE9BQU8sS0FBSyxPQUFPLE1BQU0sa0JBQWtCLENBQUM7QUFDNUMsT0FBTyxLQUFLLFdBQVcsTUFBTSx1QkFBdUIsQ0FBQztBQUVyRCxPQUFPLEVBQUUsaUJBQWlCLEVBQUUsMkJBQTJCLEVBQUUsYUFBYSxFQUFFLGlCQUFpQixFQUFFLG1CQUFtQixFQUFFLDJCQUEyQixFQUFFLG1CQUFtQixFQUFFLE1BQU0saUJBQWlCLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBHRU5FUkFURUQgYnkgcHJvamVuIHdhdGNoIC0gRE8gTk9UIEVESVQuXG4vLyBSZWdlbmVyYXRlZCBmcm9tIHRoZSBleHBvcnRpbmcgbW9kdWxlcyBpbiAuL3NyYy5cbi8vIEhhbmQgZWRpdHMgYXJlIG92ZXJ3cml0dGVuIG9uIHRoZSBuZXh0IHdhdGNoOyB0aGlzIGZpbGUgaXMgcmVhZC1vbmx5LlxuXG5leHBvcnQgY29uc3QgUEFDS0FHRV9JREVOVElGSUVSID0gXCJAZGJ4LXRvb2xzL2F1dGhcIjtcbmV4cG9ydCBjb25zdCBQQUNLQUdFX1ZFUlNJT04gPSBcIjAuOS45OVwiO1xuZXhwb3J0ICogYXMgYmluZGluZ3MgZnJvbSBcIi4vc3JjL2JpbmRpbmdzLnRzXCI7XG5leHBvcnQgKiBhcyBjbGllbnQgZnJvbSBcIi4vc3JjL2NsaWVudC50c1wiO1xuZXhwb3J0ICogYXMgY29uZmlnIGZyb20gXCIuL3NyYy9jb25maWcudHNcIjtcbmV4cG9ydCAqIGFzIHByb2ZpbGUgZnJvbSBcIi4vc3JjL3Byb2ZpbGUudHNcIjtcbmV4cG9ydCAqIGFzIHJ1bnRpbWVBdXRoIGZyb20gXCIuL3NyYy9ydW50aW1lLWF1dGgudHNcIjtcbmV4cG9ydCB0eXBlIHsgQWNjZXNzVG9rZW4sIFRva2VuT3B0aW9ucywgQXV0aENsaWVudCwgRGF0YWJyaWNrc0F1dGhEZXBlbmRlbmNpZXMgfSBmcm9tIFwiLi9zcmMvY2xpZW50LnRzXCI7XG5leHBvcnQgeyBBdXRoT3B0aW9uc1NjaGVtYSwgRGF0YWJyaWNrc0F1dGhPcHRpb25zU2NoZW1hLCBBVVRIX0RFRkFVTFRTLCBERUZBVUxUX0NMSUVOVF9JRCwgREVGQVVMVF9DT05GSUdfRklMRSwgREVGQVVMVF9BQ0NFU1NfVE9LRU5fSEVBREVSLCBXT1JLU1BBQ0VfSURfSEVBREVSIH0gZnJvbSBcIi4vc3JjL2NvbmZpZy50c1wiO1xuZXhwb3J0IHR5cGUgeyBBdXRoT3B0aW9ucywgRGF0YWJyaWNrc0F1dGhPcHRpb25zIH0gZnJvbSBcIi4vc3JjL2NvbmZpZy50c1wiO1xuZXhwb3J0IHR5cGUgeyBMaXN0UHJvZmlsZXNPcHRpb25zIH0gZnJvbSBcIi4vc3JjL3Byb2ZpbGUudHNcIjtcbmV4cG9ydCB0eXBlIHsgRGF0YWJyaWNrc1J1bnRpbWVBdXRoQ2xpZW50IH0gZnJvbSBcIi4vc3JjL3J1bnRpbWUtYXV0aC50c1wiO1xuIl19
12
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSwyQ0FBMkM7QUFDM0MsbURBQW1EO0FBQ25ELHdFQUF3RTtBQUV4RSxNQUFNLENBQUMsTUFBTSxrQkFBa0IsR0FBRyxpQkFBaUIsQ0FBQztBQUNwRCxNQUFNLENBQUMsTUFBTSxlQUFlLEdBQUcsU0FBUyxDQUFDO0FBQ3pDLE9BQU8sS0FBSyxRQUFRLE1BQU0sbUJBQW1CLENBQUM7QUFDOUMsT0FBTyxLQUFLLE1BQU0sTUFBTSxpQkFBaUIsQ0FBQztBQUMxQyxPQUFPLEtBQUssTUFBTSxNQUFNLGlCQUFpQixDQUFDO0FBQzFDLE9BQU8sS0FBSyxPQUFPLE1BQU0sa0JBQWtCLENBQUM7QUFDNUMsT0FBTyxLQUFLLFdBQVcsTUFBTSx1QkFBdUIsQ0FBQztBQUVyRCxPQUFPLEVBQUUsaUJBQWlCLEVBQUUsMkJBQTJCLEVBQUUsYUFBYSxFQUFFLGlCQUFpQixFQUFFLG1CQUFtQixFQUFFLDJCQUEyQixFQUFFLG1CQUFtQixFQUFFLE1BQU0saUJBQWlCLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBHRU5FUkFURUQgYnkgcHJvamVuIHdhdGNoIC0gRE8gTk9UIEVESVQuXG4vLyBSZWdlbmVyYXRlZCBmcm9tIHRoZSBleHBvcnRpbmcgbW9kdWxlcyBpbiAuL3NyYy5cbi8vIEhhbmQgZWRpdHMgYXJlIG92ZXJ3cml0dGVuIG9uIHRoZSBuZXh0IHdhdGNoOyB0aGlzIGZpbGUgaXMgcmVhZC1vbmx5LlxuXG5leHBvcnQgY29uc3QgUEFDS0FHRV9JREVOVElGSUVSID0gXCJAZGJ4LXRvb2xzL2F1dGhcIjtcbmV4cG9ydCBjb25zdCBQQUNLQUdFX1ZFUlNJT04gPSBcIjAuOS4xMDZcIjtcbmV4cG9ydCAqIGFzIGJpbmRpbmdzIGZyb20gXCIuL3NyYy9iaW5kaW5ncy50c1wiO1xuZXhwb3J0ICogYXMgY2xpZW50IGZyb20gXCIuL3NyYy9jbGllbnQudHNcIjtcbmV4cG9ydCAqIGFzIGNvbmZpZyBmcm9tIFwiLi9zcmMvY29uZmlnLnRzXCI7XG5leHBvcnQgKiBhcyBwcm9maWxlIGZyb20gXCIuL3NyYy9wcm9maWxlLnRzXCI7XG5leHBvcnQgKiBhcyBydW50aW1lQXV0aCBmcm9tIFwiLi9zcmMvcnVudGltZS1hdXRoLnRzXCI7XG5leHBvcnQgdHlwZSB7IEFjY2Vzc1Rva2VuLCBUb2tlbk9wdGlvbnMsIEF1dGhDbGllbnQsIERhdGFicmlja3NBdXRoRGVwZW5kZW5jaWVzIH0gZnJvbSBcIi4vc3JjL2NsaWVudC50c1wiO1xuZXhwb3J0IHsgQXV0aE9wdGlvbnNTY2hlbWEsIERhdGFicmlja3NBdXRoT3B0aW9uc1NjaGVtYSwgQVVUSF9ERUZBVUxUUywgREVGQVVMVF9DTElFTlRfSUQsIERFRkFVTFRfQ09ORklHX0ZJTEUsIERFRkFVTFRfQUNDRVNTX1RPS0VOX0hFQURFUiwgV09SS1NQQUNFX0lEX0hFQURFUiB9IGZyb20gXCIuL3NyYy9jb25maWcudHNcIjtcbmV4cG9ydCB0eXBlIHsgQXV0aE9wdGlvbnMsIERhdGFicmlja3NBdXRoT3B0aW9ucyB9IGZyb20gXCIuL3NyYy9jb25maWcudHNcIjtcbmV4cG9ydCB0eXBlIHsgTGlzdFByb2ZpbGVzT3B0aW9ucyB9IGZyb20gXCIuL3NyYy9wcm9maWxlLnRzXCI7XG5leHBvcnQgdHlwZSB7IERhdGFicmlja3NSdW50aW1lQXV0aENsaWVudCB9IGZyb20gXCIuL3NyYy9ydW50aW1lLWF1dGgudHNcIjtcbiJdfQ==
package/package.json CHANGED
@@ -24,9 +24,9 @@
24
24
  "typescript": "^5.9.3"
25
25
  },
26
26
  "dependencies": {
27
- "@dbx-tools/core": "^0.9.99",
28
- "@dbx-tools/shared-auth": "^0.9.99",
29
- "@dbx-tools/shared-core": "^0.9.99",
27
+ "@dbx-tools/core": "^0.9.106",
28
+ "@dbx-tools/shared-auth": "^0.9.106",
29
+ "@dbx-tools/shared-core": "^0.9.106",
30
30
  "ini": "^6.0.0",
31
31
  "oauth4webapi": "^3.8.8",
32
32
  "zod": "4.3.6"
@@ -65,7 +65,7 @@
65
65
  "./package.json": "./package.json"
66
66
  }
67
67
  },
68
- "version": "0.9.99",
68
+ "version": "0.9.106",
69
69
  "types": "./lib/index.d.ts",
70
70
  "dbxToolsConfig": {
71
71
  "tags": [