@fabric-harness/databricks 4.3.0 → 4.3.1

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.
@@ -0,0 +1,49 @@
1
+ import { type DatabricksCertificationEvidence } from "./certification.js";
2
+ export interface DatabricksAppRecoveryEvidence {
3
+ schemaVersion: number;
4
+ target: string;
5
+ preparedAt?: string;
6
+ verifiedAt?: string;
7
+ restartRecovery?: {
8
+ deploymentIdChanged?: boolean;
9
+ sourceCodePathPreserved?: boolean;
10
+ session?: boolean;
11
+ submission?: boolean;
12
+ conversationOffset?: boolean;
13
+ attachment?: boolean;
14
+ };
15
+ approvalRecovery?: {
16
+ identityPreserved?: boolean;
17
+ resumedAfterRestart?: boolean;
18
+ completedAfterApproval?: boolean;
19
+ };
20
+ cascadeDeletion?: {
21
+ sessions?: number;
22
+ submissions?: number;
23
+ conversationStreams?: number;
24
+ attachments?: number;
25
+ };
26
+ }
27
+ export interface ValidateDatabricksReleaseEvidenceOptions {
28
+ evidence: DatabricksCertificationEvidence;
29
+ expectedPackageVersion: string;
30
+ expectedCommitSha: string;
31
+ expectedPackageArtifactSha256: string;
32
+ expectedAppArtifactSha256: string;
33
+ expectedRelatedEvidenceSha256?: Readonly<Record<string, string>>;
34
+ maxAgeMs?: number;
35
+ now?: Date;
36
+ }
37
+ export interface DatabricksReleaseEvidenceValidation {
38
+ valid: true;
39
+ evidenceId: string;
40
+ packageVersion: string;
41
+ requiredChecks: readonly string[];
42
+ }
43
+ /**
44
+ * Fail closed unless retained Databricks evidence proves the exact release commit and artifacts.
45
+ */
46
+ export declare function validateDatabricksReleaseEvidence(options: ValidateDatabricksReleaseEvidenceOptions): DatabricksReleaseEvidenceValidation;
47
+ /** Assert that App restart evidence proves durable state, approval recovery, and cascade cleanup. */
48
+ export declare function validateDatabricksAppRecoveryEvidence(evidence: DatabricksAppRecoveryEvidence): void;
49
+ //# sourceMappingURL=release-evidence.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"release-evidence.d.ts","sourceRoot":"","sources":["../src/release-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,6BAA6B;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE;QAChB,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,uBAAuB,CAAC,EAAE,OAAO,CAAC;QAClC,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;IACF,gBAAgB,CAAC,EAAE;QACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,sBAAsB,CAAC,EAAE,OAAO,CAAC;KAClC,CAAC;IACF,eAAe,CAAC,EAAE;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,wCAAwC;IACvD,QAAQ,EAAE,+BAA+B,CAAC;IAC1C,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,6BAA6B,EAAE,MAAM,CAAC;IACtC,yBAAyB,EAAE,MAAM,CAAC;IAClC,6BAA6B,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,mCAAmC;IAClD,KAAK,EAAE,IAAI,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,wCAAwC,GAChD,mCAAmC,CAkFrC;AAED,qGAAqG;AACrG,wBAAgB,qCAAqC,CACnD,QAAQ,EAAE,6BAA6B,GACtC,IAAI,CAoCN"}
@@ -45,5 +45,23 @@ export interface DatabricksSqlSandboxOptions {
45
45
  /** Inject a pre-built native Statement Execution client. */
46
46
  client?: Pick<StatementExecutionClient, 'executeStatement'>;
47
47
  }
48
+ export interface DatabricksSqlSandboxRefData {
49
+ host: string;
50
+ warehouseId: string;
51
+ catalog?: string;
52
+ schema?: string;
53
+ resultFormat?: 'jsonl' | 'csv';
54
+ waitTimeoutSeconds?: number;
55
+ }
56
+ export interface DatabricksSqlSandboxRegistrationOptions {
57
+ /** Resolve credentials at creation/attach time. Credentials are never stored in a sandbox ref. */
58
+ resolvePrincipal?: (env: Record<string, string | undefined>, target: DatabricksSqlSandboxRefData) => DatabricksPrincipal;
59
+ /** Inject a client for tests or a provider-owned transport. */
60
+ client?: Pick<StatementExecutionClient, 'executeStatement'>;
61
+ }
48
62
  export declare function databricksSqlSandbox(options: DatabricksSqlSandboxOptions): SandboxEnv;
63
+ /** Register `sandbox: 'databricks'` and its credential-safe portable-ref decoder. */
64
+ export declare function registerDatabricksSqlSandboxBackend(registration?: DatabricksSqlSandboxRegistrationOptions): void;
65
+ /** Remove both process-local registrations, primarily for tests and controlled shutdown. */
66
+ export declare function unregisterDatabricksSqlSandboxBackend(): void;
49
67
  //# sourceMappingURL=sql-sandbox.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"sql-sandbox.d.ts","sourceRoot":"","sources":["../src/sql-sandbox.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAoB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,KAAK,EAAc,wBAAwB,EAAqB,MAAM,uCAAuC,CAAC;AACrH,OAAO,EAA6C,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpG;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,mBAAmB,CAAC;IAC/B,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,YAAY,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAC/B,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,kBAAkB,CAAC,CAAC;CAC7D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,UAAU,CAwFrF"}
1
+ {"version":3,"file":"sql-sandbox.d.ts","sourceRoot":"","sources":["../src/sql-sandbox.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAoB,UAAU,EAAyB,MAAM,qBAAqB,CAAC;AAC/F,OAAO,KAAK,EAAc,wBAAwB,EAAqB,MAAM,uCAAuC,CAAC;AACrH,OAAO,EAAyE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGhI;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,mBAAmB,CAAC;IAC/B,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,YAAY,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAC/B,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,kBAAkB,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,uCAAuC;IACtD,kGAAkG;IAClG,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE,MAAM,EAAE,2BAA2B,KAAK,mBAAmB,CAAC;IACzH,+DAA+D;IAC/D,MAAM,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,kBAAkB,CAAC,CAAC;CAC7D;AAID,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,UAAU,CA4FrF;AAED,qFAAqF;AACrF,wBAAgB,mCAAmC,CAAC,YAAY,GAAE,uCAA4C,GAAG,IAAI,CAUpH;AAED,4FAA4F;AAC5F,wBAAgB,qCAAqC,IAAI,IAAI,CAG5D"}
@@ -1793,7 +1793,7 @@ var require_json_bigint = __commonJS({
1793
1793
  });
1794
1794
 
1795
1795
  // src/sql-sandbox.ts
1796
- import { createRemoteSandboxEnv } from "@fabric-harness/sdk";
1796
+ import { createRemoteSandboxEnv, registerSandboxBackendFactory, registerSandboxRefDecoder, unregisterSandboxBackendFactory, unregisterSandboxRefDecoder } from "@fabric-harness/sdk";
1797
1797
 
1798
1798
  // ../../node_modules/.pnpm/@databricks+sdk-auth@0.21.0/node_modules/@databricks/sdk-auth/package.json
1799
1799
  var package_default = {
@@ -17162,6 +17162,38 @@ function databricksIdentity(principal) {
17162
17162
  if (principal.kind === "on-behalf-of") return async () => principal.userToken();
17163
17163
  return tokenProviderFromCredentials(databricksCredentials(principal));
17164
17164
  }
17165
+ function databricksPrincipalFromEnv(env2 = typeof process !== "undefined" ? process.env : {}, options = {}) {
17166
+ const tokenName = options.tokenEnv ?? "DATABRICKS_TOKEN";
17167
+ const clientIdName = options.clientIdEnv ?? "DATABRICKS_CLIENT_ID";
17168
+ const clientSecretName = options.clientSecretEnv ?? "DATABRICKS_CLIENT_SECRET";
17169
+ const hostName = options.hostEnv ?? "DATABRICKS_HOST";
17170
+ const profileName = options.profileEnv ?? "DATABRICKS_CONFIG_PROFILE";
17171
+ const token = env2.DATABRICKS_BEARER?.trim() || env2[tokenName]?.trim();
17172
+ if (token) return { kind: "pat", token };
17173
+ const clientId = env2[clientIdName]?.trim();
17174
+ const clientSecret = env2[clientSecretName]?.trim();
17175
+ const rawHost = env2[hostName]?.trim();
17176
+ if (clientId && clientSecret) {
17177
+ if (!rawHost) throw new Error(`Missing ${hostName} for Databricks OAuth M2M.`);
17178
+ return {
17179
+ kind: "service-principal",
17180
+ host: databricksWorkspaceOrigin(rawHost),
17181
+ clientId,
17182
+ clientSecret
17183
+ };
17184
+ }
17185
+ const profile = env2[profileName]?.trim() || env2.DATABRICKS_PROFILE?.trim();
17186
+ if (rawHost && (profile || env2.DATABRICKS_AUTH_MODE === "cli")) {
17187
+ return {
17188
+ kind: "cli-profile",
17189
+ host: databricksWorkspaceOrigin(rawHost),
17190
+ ...profile ? { profile } : {}
17191
+ };
17192
+ }
17193
+ throw new Error(
17194
+ `Set DATABRICKS_BEARER/${tokenName}, ${clientIdName} + ${clientSecretName}, or ${hostName} + ${profileName}.`
17195
+ );
17196
+ }
17165
17197
  function cliProfileCredentials(principal) {
17166
17198
  let resolved;
17167
17199
  return {
@@ -52777,6 +52809,7 @@ function fabricHttpClient(fetchImpl, extraHeaders) {
52777
52809
  }
52778
52810
 
52779
52811
  // src/sql-sandbox.ts
52812
+ var DATABRICKS_SQL_SANDBOX_REF_PROVIDER = "databricks-sql";
52780
52813
  function databricksSqlSandbox(options) {
52781
52814
  const identity = databricksIdentity(options.principal);
52782
52815
  const client = options.client ?? createDatabricksNativeClients({
@@ -52863,9 +52896,85 @@ function databricksSqlSandbox(options) {
52863
52896
  };
52864
52897
  return createRemoteSandboxEnv(api, {
52865
52898
  cwd: "/workspace",
52866
- capabilities: { exec: true, filesystem: true, binaryFiles: true, snapshots: false, restore: false, network: "provider-managed", persistence: "session", isolation: "provider" }
52899
+ capabilities: { exec: true, filesystem: true, binaryFiles: true, snapshots: false, restore: false, reconnect: true, network: "provider-managed", persistence: "session", isolation: "provider" },
52900
+ encodeRef: () => ({
52901
+ provider: DATABRICKS_SQL_SANDBOX_REF_PROVIDER,
52902
+ providerData: databricksSqlSandboxRefData(options)
52903
+ })
52904
+ });
52905
+ }
52906
+ function registerDatabricksSqlSandboxBackend(registration = {}) {
52907
+ registerSandboxBackendFactory("databricks", (factoryOptions) => createRegisteredDatabricksSqlSandbox(factoryOptions, registration));
52908
+ registerSandboxRefDecoder(DATABRICKS_SQL_SANDBOX_REF_PROVIDER, (providerData) => {
52909
+ const target = assertDatabricksSqlSandboxRefData(providerData);
52910
+ return (factoryOptions) => databricksSqlSandbox({
52911
+ ...target,
52912
+ principal: resolveRegisteredPrincipal(factoryOptions, target, registration),
52913
+ ...registration.client ? { client: registration.client } : {}
52914
+ });
52915
+ });
52916
+ }
52917
+ function unregisterDatabricksSqlSandboxBackend() {
52918
+ unregisterSandboxBackendFactory("databricks");
52919
+ unregisterSandboxRefDecoder(DATABRICKS_SQL_SANDBOX_REF_PROVIDER);
52920
+ }
52921
+ function createRegisteredDatabricksSqlSandbox(options, registration) {
52922
+ const env2 = options.env ?? process.env;
52923
+ const metadata = options.metadata ?? {};
52924
+ const catalog = metadataString(metadata, "databricksCatalog") ?? env2.DATABRICKS_CATALOG;
52925
+ const schema = metadataString(metadata, "databricksSchema") ?? env2.DATABRICKS_SCHEMA;
52926
+ const resultFormat = metadataString(metadata, "databricksResultFormat");
52927
+ const target = {
52928
+ host: metadataString(metadata, "databricksHost") ?? env2.DATABRICKS_HOST ?? "",
52929
+ warehouseId: metadataString(metadata, "databricksWarehouseId") ?? env2.DATABRICKS_WAREHOUSE_ID ?? "",
52930
+ ...catalog ? { catalog } : {},
52931
+ ...schema ? { schema } : {},
52932
+ ...resultFormat ? { resultFormat: assertResultFormat(resultFormat) } : {}
52933
+ };
52934
+ assertDatabricksSqlSandboxRefData(target);
52935
+ return databricksSqlSandbox({
52936
+ ...target,
52937
+ principal: resolveRegisteredPrincipal(options, target, registration),
52938
+ ...registration.client ? { client: registration.client } : {}
52867
52939
  });
52868
52940
  }
52941
+ function resolveRegisteredPrincipal(options, target, registration) {
52942
+ const env2 = options.env ?? process.env;
52943
+ return registration.resolvePrincipal?.(env2, target) ?? databricksPrincipalFromEnv(env2);
52944
+ }
52945
+ function databricksSqlSandboxRefData(options) {
52946
+ return {
52947
+ host: options.host,
52948
+ warehouseId: options.warehouseId,
52949
+ ...options.catalog ? { catalog: options.catalog } : {},
52950
+ ...options.schema ? { schema: options.schema } : {},
52951
+ ...options.resultFormat ? { resultFormat: options.resultFormat } : {},
52952
+ ...options.waitTimeoutSeconds !== void 0 ? { waitTimeoutSeconds: options.waitTimeoutSeconds } : {}
52953
+ };
52954
+ }
52955
+ function assertDatabricksSqlSandboxRefData(value) {
52956
+ if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("Invalid Databricks SQL sandbox reference.");
52957
+ const data = value;
52958
+ if (typeof data.host !== "string" || data.host.trim().length === 0) throw new Error("Databricks SQL sandbox reference is missing host.");
52959
+ if (typeof data.warehouseId !== "string" || data.warehouseId.trim().length === 0) throw new Error("Databricks SQL sandbox reference is missing warehouseId.");
52960
+ const result = { host: data.host, warehouseId: data.warehouseId };
52961
+ if (typeof data.catalog === "string") result.catalog = data.catalog;
52962
+ if (typeof data.schema === "string") result.schema = data.schema;
52963
+ if (data.resultFormat !== void 0) result.resultFormat = assertResultFormat(data.resultFormat);
52964
+ if (data.waitTimeoutSeconds !== void 0) {
52965
+ if (typeof data.waitTimeoutSeconds !== "number" || !Number.isFinite(data.waitTimeoutSeconds)) throw new Error("Databricks SQL sandbox reference has an invalid waitTimeoutSeconds.");
52966
+ result.waitTimeoutSeconds = data.waitTimeoutSeconds;
52967
+ }
52968
+ return result;
52969
+ }
52970
+ function metadataString(metadata, key) {
52971
+ const value = metadata[key];
52972
+ return typeof value === "string" && value.trim().length > 0 ? value : void 0;
52973
+ }
52974
+ function assertResultFormat(value) {
52975
+ if (value === "jsonl" || value === "csv") return value;
52976
+ throw new Error("Databricks SQL sandbox result format must be jsonl or csv.");
52977
+ }
52869
52978
  function serializeResult(response, format) {
52870
52979
  const columns = response.manifest?.schema?.columns?.map((c2) => c2.name ?? "") ?? [];
52871
52980
  const rows = response.result?.dataArray ?? [];
@@ -52886,6 +52995,8 @@ function formatCsvCell(value) {
52886
52995
  return /[",\n]/.test(str) ? `"${str.replace(/"/g, '""')}"` : str;
52887
52996
  }
52888
52997
  export {
52889
- databricksSqlSandbox
52998
+ databricksSqlSandbox,
52999
+ registerDatabricksSqlSandboxBackend,
53000
+ unregisterDatabricksSqlSandboxBackend
52890
53001
  };
52891
53002
  //# sourceMappingURL=sql-sandbox.js.map