@databricks/sdk-options 0.1.0-dev.1 → 0.1.0-dev.3

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.
@@ -3,7 +3,7 @@
3
3
  *
4
4
  * @packageDocumentation
5
5
  */
6
- import type { Limiter, Retrier } from '@databricks/sdk-core/api';
6
+ import type { Limiter, Retrier } from '@databricks/sdk-core/ops';
7
7
  /** Options that configure a single call against the Databricks API. */
8
8
  export interface CallOptions {
9
9
  /**
@@ -0,0 +1,28 @@
1
+ /**
2
+ * Options used to configure waiting on a long-running operation.
3
+ *
4
+ * @packageDocumentation
5
+ */
6
+ /**
7
+ * Options that configure waiting on a long-running operation.
8
+ *
9
+ * A wait may issue many polling calls under the hood; these options apply to
10
+ * the entire wait, not to any single poll. Per-poll knobs (rate limiting,
11
+ * retry strategy) are intentionally omitted to keep the surface focused on
12
+ * the only thing callers reliably need: bounding how long to wait.
13
+ */
14
+ export interface LroOptions {
15
+ /**
16
+ * Cancels the wait when aborted. If {@link LroOptions.timeout} is also
17
+ * set, the wait is cancelled when either the signal aborts or the timeout
18
+ * elapses, whichever happens first.
19
+ */
20
+ signal?: AbortSignal;
21
+ /**
22
+ * Total timeout, in milliseconds, that bounds the entire wait, including
23
+ * all polling attempts. If the signal already has a deadline, it is
24
+ * updated to the minimum of the signal's deadline and this timeout.
25
+ */
26
+ timeout?: number;
27
+ }
28
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lro/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Options used to configure waiting on a long-running operation.
3
+ *
4
+ * @packageDocumentation
5
+ */
6
+ export {};
7
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lro/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@databricks/sdk-options",
3
- "version": "0.1.0-dev.1",
3
+ "version": "0.1.0-dev.3",
4
4
  "description": "Options for configuring Databricks API clients and individual calls.",
5
5
  "type": "module",
6
6
  "exports": {
@@ -11,6 +11,10 @@
11
11
  "./call": {
12
12
  "types": "./dist/call/index.d.ts",
13
13
  "import": "./dist/call/index.js"
14
+ },
15
+ "./lro": {
16
+ "types": "./dist/lro/index.d.ts",
17
+ "import": "./dist/lro/index.js"
14
18
  }
15
19
  },
16
20
  "files": [
@@ -35,7 +39,7 @@
35
39
  "node": ">=22.0.0"
36
40
  },
37
41
  "dependencies": {
38
- "@databricks/sdk-auth": ">=0.1.0-dev.1 <1.0.0",
39
- "@databricks/sdk-core": ">=0.1.0-dev.2 <1.0.0"
42
+ "@databricks/sdk-auth": ">=0.1.0-dev.3 <1.0.0",
43
+ "@databricks/sdk-core": ">=0.1.0-dev.4 <1.0.0"
40
44
  }
41
45
  }
package/src/call/index.ts CHANGED
@@ -4,7 +4,7 @@
4
4
  * @packageDocumentation
5
5
  */
6
6
 
7
- import type {Limiter, Retrier} from '@databricks/sdk-core/api';
7
+ import type {Limiter, Retrier} from '@databricks/sdk-core/ops';
8
8
 
9
9
  /** Options that configure a single call against the Databricks API. */
10
10
  export interface CallOptions {
@@ -0,0 +1,29 @@
1
+ /**
2
+ * Options used to configure waiting on a long-running operation.
3
+ *
4
+ * @packageDocumentation
5
+ */
6
+
7
+ /**
8
+ * Options that configure waiting on a long-running operation.
9
+ *
10
+ * A wait may issue many polling calls under the hood; these options apply to
11
+ * the entire wait, not to any single poll. Per-poll knobs (rate limiting,
12
+ * retry strategy) are intentionally omitted to keep the surface focused on
13
+ * the only thing callers reliably need: bounding how long to wait.
14
+ */
15
+ export interface LroOptions {
16
+ /**
17
+ * Cancels the wait when aborted. If {@link LroOptions.timeout} is also
18
+ * set, the wait is cancelled when either the signal aborts or the timeout
19
+ * elapses, whichever happens first.
20
+ */
21
+ signal?: AbortSignal;
22
+
23
+ /**
24
+ * Total timeout, in milliseconds, that bounds the entire wait, including
25
+ * all polling attempts. If the signal already has a deadline, it is
26
+ * updated to the minimum of the signal's deadline and this timeout.
27
+ */
28
+ timeout?: number;
29
+ }