@fabric-harness/databricks 4.1.0 → 4.2.0
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 +6 -6
- package/dist/agent.js +46 -3
- package/dist/agent.js.map +1 -1
- package/dist/app-deployment.d.ts +71 -0
- package/dist/app-deployment.d.ts.map +1 -0
- package/dist/app-user-authorization.d.ts +17 -1
- package/dist/app-user-authorization.d.ts.map +1 -1
- package/dist/app-user-authorization.js +38942 -0
- package/dist/app-user-authorization.js.map +1 -0
- package/dist/certification.d.ts.map +1 -1
- package/dist/certify.js +94 -9
- package/dist/certify.js.map +1 -1
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +361 -87
- package/dist/index.js.map +1 -1
- package/dist/raw-protocol-client.d.ts.map +1 -1
- package/dist/sdk-error.d.ts +4 -0
- package/dist/sdk-error.d.ts.map +1 -0
- package/dist/sql-sandbox.js +5 -0
- package/dist/sql-sandbox.js.map +1 -1
- package/dist/vector-search.d.ts +10 -4
- package/dist/vector-search.d.ts.map +1 -1
- package/package.json +7 -3
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
export interface DatabricksCommandResult {
|
|
2
|
+
exitCode: number;
|
|
3
|
+
stdout: string;
|
|
4
|
+
stderr: string;
|
|
5
|
+
}
|
|
6
|
+
export type DatabricksCommandRunner = (command: string, args: readonly string[], options: {
|
|
7
|
+
cwd: string;
|
|
8
|
+
env: NodeJS.ProcessEnv;
|
|
9
|
+
}) => Promise<DatabricksCommandResult>;
|
|
10
|
+
export interface DeployDatabricksAppArtifactOptions {
|
|
11
|
+
/** Immutable Fabric Harness `databricks-app` build directory. */
|
|
12
|
+
artifactDir: string;
|
|
13
|
+
/** Databricks CLI profile. App identity/environment auth is used when omitted. */
|
|
14
|
+
profile?: string;
|
|
15
|
+
/** Asset Bundle target selected by the governed release environment. */
|
|
16
|
+
target?: string;
|
|
17
|
+
/** Databricks CLI executable; defaults to `databricks`. */
|
|
18
|
+
executable?: string;
|
|
19
|
+
env?: NodeJS.ProcessEnv;
|
|
20
|
+
/** Injectable command boundary for tests and managed runners. */
|
|
21
|
+
run?: DatabricksCommandRunner;
|
|
22
|
+
onCommand?: (command: {
|
|
23
|
+
executable: string;
|
|
24
|
+
args: readonly string[];
|
|
25
|
+
}) => void;
|
|
26
|
+
/** Explicit Databricks App resource to activate after bundle synchronization. */
|
|
27
|
+
appName?: string;
|
|
28
|
+
/** Bundle-synchronized workspace source path used for snapshot activation. */
|
|
29
|
+
sourceCodePath?: string;
|
|
30
|
+
/** App deployment mode; Databricks Apps currently supports SNAPSHOT here. */
|
|
31
|
+
mode?: "SNAPSHOT";
|
|
32
|
+
/** Start stopped App compute before activating the snapshot. */
|
|
33
|
+
startBeforeDeploy?: boolean;
|
|
34
|
+
}
|
|
35
|
+
export interface DeployDatabricksAppArtifactResult {
|
|
36
|
+
bundleSynchronized: true;
|
|
37
|
+
appSnapshotActivated: true;
|
|
38
|
+
bundleOutput: string;
|
|
39
|
+
appOutput: string;
|
|
40
|
+
}
|
|
41
|
+
export interface ValidateDatabricksAppArtifactOptions {
|
|
42
|
+
artifactDir: string;
|
|
43
|
+
profile?: string;
|
|
44
|
+
target?: string;
|
|
45
|
+
executable?: string;
|
|
46
|
+
env?: NodeJS.ProcessEnv;
|
|
47
|
+
run?: DatabricksCommandRunner;
|
|
48
|
+
onCommand?: (command: {
|
|
49
|
+
executable: string;
|
|
50
|
+
args: readonly string[];
|
|
51
|
+
}) => void;
|
|
52
|
+
}
|
|
53
|
+
export interface ValidateDatabricksAppArtifactResult {
|
|
54
|
+
valid: true;
|
|
55
|
+
output: string;
|
|
56
|
+
}
|
|
57
|
+
/** Validate an already-built Databricks App artifact without mutating the workspace. */
|
|
58
|
+
export declare function validateDatabricksAppArtifact(options: ValidateDatabricksAppArtifactOptions): Promise<ValidateDatabricksAppArtifactResult>;
|
|
59
|
+
/**
|
|
60
|
+
* Deploy an already-built Fabric Harness Databricks App artifact.
|
|
61
|
+
*
|
|
62
|
+
* This is the programmatic counterpart of `fh deploy --target databricks-app`.
|
|
63
|
+
* It intentionally does not rebuild the artifact: release orchestrators can verify
|
|
64
|
+
* the immutable digest first, then use this function for the Databricks side effect.
|
|
65
|
+
*/
|
|
66
|
+
export declare function deployDatabricksAppArtifact(options: DeployDatabricksAppArtifactOptions): Promise<DeployDatabricksAppArtifactResult>;
|
|
67
|
+
export declare function runDatabricksCommand(command: string, args: readonly string[], options: {
|
|
68
|
+
cwd: string;
|
|
69
|
+
env: NodeJS.ProcessEnv;
|
|
70
|
+
}): Promise<DatabricksCommandResult>;
|
|
71
|
+
//# sourceMappingURL=app-deployment.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"app-deployment.d.ts","sourceRoot":"","sources":["../src/app-deployment.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,uBAAuB,GAAG,CACpC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KAC7C,OAAO,CAAC,uBAAuB,CAAC,CAAC;AAEtC,MAAM,WAAW,kCAAkC;IACjD,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,iEAAiE;IACjE,GAAG,CAAC,EAAE,uBAAuB,CAAC;IAC9B,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/E,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,iCAAiC;IAChD,kBAAkB,EAAE,IAAI,CAAC;IACzB,oBAAoB,EAAE,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oCAAoC;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,uBAAuB,CAAC;IAC9B,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,KAAK,IAAI,CAAC;CAChF;AAED,MAAM,WAAW,mCAAmC;IAClD,KAAK,EAAE,IAAI,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wFAAwF;AACxF,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,oCAAoC,GAC5C,OAAO,CAAC,mCAAmC,CAAC,CAkB9C;AAED;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,iCAAiC,CAAC,CA6C5C;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,GAC/C,OAAO,CAAC,uBAAuB,CAAC,CAmBlC"}
|
|
@@ -14,7 +14,7 @@ export interface DatabricksAppUserAuthorizationInspection {
|
|
|
14
14
|
}
|
|
15
15
|
export interface DatabricksAppAuthenticatedPrincipal {
|
|
16
16
|
id: string;
|
|
17
|
-
kind: "user";
|
|
17
|
+
kind: "user" | "service-principal" | "app-principal";
|
|
18
18
|
displayName?: string;
|
|
19
19
|
provider: "databricks-apps";
|
|
20
20
|
tenantId: string;
|
|
@@ -30,6 +30,22 @@ export interface DatabricksAppUserAuthenticatorOptions {
|
|
|
30
30
|
tenantId?: (inspection: DatabricksAppUserAuthorizationInspection) => string;
|
|
31
31
|
/** Override the least-privilege permissions granted to an authenticated App user. */
|
|
32
32
|
permissions?: string[];
|
|
33
|
+
/**
|
|
34
|
+
* Trust Databricks Apps reverse-proxy identity headers for M2M API calls that do not carry an
|
|
35
|
+
* OBO user token. Enable only when this server is exclusively behind Databricks Apps ingress.
|
|
36
|
+
*/
|
|
37
|
+
trustForwardedServicePrincipal?: boolean;
|
|
38
|
+
/**
|
|
39
|
+
* Treat requests without an OBO user token as App authorization and bind them to this App's
|
|
40
|
+
* injected service principal. Enable only behind Databricks Apps ingress.
|
|
41
|
+
*/
|
|
42
|
+
appPrincipalId?: string;
|
|
43
|
+
/**
|
|
44
|
+
* Service-principal IDs allowed to use App authorization when Databricks forwards their M2M
|
|
45
|
+
* token through the OBO header. Values are matched against proxy identity headers and safe JWT
|
|
46
|
+
* identity claims. Other forwarded tokens remain on the fail-closed OBO path.
|
|
47
|
+
*/
|
|
48
|
+
appAuthorizedCallerIds?: string[];
|
|
33
49
|
now?: () => number;
|
|
34
50
|
}
|
|
35
51
|
export declare const DATABRICKS_APP_USER_PERMISSIONS: readonly ["agent:invoke", "approval:read", "approval:write", "artifact:read", "mcp:invoke", "session:abort", "session:delete", "session:read"];
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"app-user-authorization.d.ts","sourceRoot":"","sources":["../src/app-user-authorization.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAS3D,MAAM,WAAW,wCAAwC;IACvD,SAAS,EAAE,eAAe,CAAC;IAC3B,iBAAiB,EAAE;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,mCAAmC;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;
|
|
1
|
+
{"version":3,"file":"app-user-authorization.d.ts","sourceRoot":"","sources":["../src/app-user-authorization.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAS3D,MAAM,WAAW,wCAAwC;IACvD,SAAS,EAAE,eAAe,CAAC;IAC3B,iBAAiB,EAAE;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,mCAAmC;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,eAAe,CAAC;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qCAAqC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,kGAAkG;IAClG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gGAAgG;IAChG,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,wCAAwC,KAAK,MAAM,CAAC;IAC5E,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;OAGG;IACH,8BAA8B,CAAC,EAAE,OAAO,CAAC;IACzC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,+BAA+B,gJASlC,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,qCAAqC,GAC7C,CAAC,OAAO,EAAE;IACX,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;CAClE,KAAK,OAAO,CAAC,mCAAmC,GAAG,KAAK,GAAG,SAAS,CAAC,CAmFrE;AAyDD;;;;GAIG;AACH,wBAAsB,qCAAqC,CAAC,OAAO,EAAE;IACnE,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,wCAAwC,CAAC,CAmDpD"}
|