@databricks/sdk-core 0.0.0-dev → 0.1.0-dev.2

package/dist/logger/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Logger interface and built-in implementations.
+ *
+ * @packageDocumentation
+ */
+export type { Level, Logger } from './logger';
+export { NoOpLogger, LogLevel } from './logger';
+//# sourceMappingURL=index.d.ts.map

package/dist/logger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logger/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAC,KAAK,EAAE,MAAM,EAAC,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAC,UAAU,EAAE,QAAQ,EAAC,MAAM,UAAU,CAAC"}

package/dist/logger/index.js

@@ -0,0 +1,7 @@
+/**
+ * Logger interface and built-in implementations.
+ *
+ * @packageDocumentation
+ */
+export { NoOpLogger, LogLevel } from './logger';
+//# sourceMappingURL=index.js.map

package/dist/logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logger/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAC,UAAU,EAAE,QAAQ,EAAC,MAAM,UAAU,CAAC"}

package/dist/logger/logger.d.ts

@@ -0,0 +1,49 @@
+/** Logger interface and built-in implementations. */
+/** Supported log levels in order of increasing severity. */
+export type Level = 'debug' | 'info' | 'warn' | 'error' | 'off';
+/**
+ * A logger that receives messages at different severity levels.
+ *
+ * The method signatures are intentionally compatible with the global
+ * {@link Console} object so that `console` can be used as a Logger when level
+ * filtering is not needed.
+ */
+export interface Logger {
+    /** Logs a debug-level message. */
+    debug(message: string, ...args: unknown[]): void;
+    /** Logs an info-level message. */
+    info(message: string, ...args: unknown[]): void;
+    /** Logs a warn-level message. */
+    warn(message: string, ...args: unknown[]): void;
+    /** Logs an error-level message. */
+    error(message: string, ...args: unknown[]): void;
+}
+/** A logger that silently discards all messages. */
+export declare class NoOpLogger implements Logger {
+    debug(): void;
+    info(): void;
+    warn(): void;
+    error(): void;
+}
+/**
+ * A decorator that adds level filtering to any {@link Logger}.
+ *
+ * Only messages at or above the configured minimum level are forwarded to the
+ * underlying logger. The default underlying logger is `console`.
+ *
+ * @example
+ * ```typescript
+ * // Only warn and error go to console.
+ * const logger = new LogLevel('warn');
+ * ```
+ */
+export declare class LogLevel implements Logger {
+    private readonly threshold;
+    private readonly logger;
+    constructor(level: Level, logger?: Logger);
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":"AAAA,qDAAqD;AAErD,4DAA4D;AAC5D,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,WAAW,MAAM;IACrB,kCAAkC;IAClC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEjD,kCAAkC;IAClC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEhD,iCAAiC;IACjC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEhD,mCAAmC;IACnC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClD;AAED,oDAAoD;AACpD,qBAAa,UAAW,YAAW,MAAM;IACvC,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI;IAIZ,IAAI,IAAI,IAAI;IAIZ,KAAK,IAAI,IAAI;CAGd;AAWD;;;;;;;;;;;GAWG;AACH,qBAAa,QAAS,YAAW,MAAM;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,KAAK,EAAE,KAAK,EAAE,MAAM,GAAE,MAAgB;IAKlD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAKjD"}

package/dist/logger/logger.js

@@ -0,0 +1,65 @@
+/** Logger interface and built-in implementations. */
+/** A logger that silently discards all messages. */
+export class NoOpLogger {
+    debug() {
+        // Intentionally empty.
+    }
+    info() {
+        // Intentionally empty.
+    }
+    warn() {
+        // Intentionally empty.
+    }
+    error() {
+        // Intentionally empty.
+    }
+}
+// Numeric severity used by LogLevel to gate calls.
+const LEVEL_SEVERITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    off: 4,
+};
+/**
+ * A decorator that adds level filtering to any {@link Logger}.
+ *
+ * Only messages at or above the configured minimum level are forwarded to the
+ * underlying logger. The default underlying logger is `console`.
+ *
+ * @example
+ * ```typescript
+ * // Only warn and error go to console.
+ * const logger = new LogLevel('warn');
+ * ```
+ */
+export class LogLevel {
+    threshold;
+    logger;
+    constructor(level, logger = console) {
+        this.threshold = LEVEL_SEVERITY[level];
+        this.logger = logger;
+    }
+    debug(message, ...args) {
+        if (this.threshold <= LEVEL_SEVERITY.debug) {
+            this.logger.debug(message, ...args);
+        }
+    }
+    info(message, ...args) {
+        if (this.threshold <= LEVEL_SEVERITY.info) {
+            this.logger.info(message, ...args);
+        }
+    }
+    warn(message, ...args) {
+        if (this.threshold <= LEVEL_SEVERITY.warn) {
+            this.logger.warn(message, ...args);
+        }
+    }
+    error(message, ...args) {
+        if (this.threshold <= LEVEL_SEVERITY.error) {
+            this.logger.error(message, ...args);
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":"AAAA,qDAAqD;AA0BrD,oDAAoD;AACpD,MAAM,OAAO,UAAU;IACrB,KAAK;QACH,uBAAuB;IACzB,CAAC;IAED,IAAI;QACF,uBAAuB;IACzB,CAAC;IAED,IAAI;QACF,uBAAuB;IACzB,CAAC;IAED,KAAK;QACH,uBAAuB;IACzB,CAAC;CACF;AAED,mDAAmD;AACnD,MAAM,cAAc,GAA0B;IAC5C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,GAAG,EAAE,CAAC;CACP,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,QAAQ;IACF,SAAS,CAAS;IAClB,MAAM,CAAS;IAEhC,YAAY,KAAY,EAAE,SAAiB,OAAO;QAChD,IAAI,CAAC,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,IAAI,CAAC,SAAS,IAAI,cAAc,CAAC,KAAK,EAAE,CAAC;YAC3C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,IAAI,CAAC,SAAS,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC;YAC1C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,IAAI,CAAC,SAAS,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC;YAC1C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,IAAI,CAAC,SAAS,IAAI,cAAc,CAAC,KAAK,EAAE,CAAC;YAC3C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;CACF"}

package/dist/profiles/errors.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Error types for Databricks configuration profile operations.
+ *
+ * @module
+ */
+/** Discriminant codes for {@link ProfileError}. */
+export type ProfileErrorCode = 'CONFIG_FILE_NOT_FOUND' | 'PROFILE_NOT_FOUND' | 'EMPTY_PATH' | 'EMPTY_PROFILE' | 'INVALID_PROFILE_NAME';
+/**
+ * Error thrown by profile operations.
+ *
+ * Use the {@link ProfileError.code} field to distinguish between error causes.
+ */
+export declare class ProfileError extends Error {
+    readonly code: ProfileErrorCode;
+    constructor(code: ProfileErrorCode, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/profiles/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/profiles/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mDAAmD;AACnD,MAAM,MAAM,gBAAgB,GACxB,uBAAuB,GACvB,mBAAmB,GACnB,YAAY,GACZ,eAAe,GACf,sBAAsB,CAAC;AAE3B;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;gBAEpB,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM;CAKpD"}

package/dist/profiles/errors.js

@@ -0,0 +1,19 @@
+/**
+ * Error types for Databricks configuration profile operations.
+ *
+ * @module
+ */
+/**
+ * Error thrown by profile operations.
+ *
+ * Use the {@link ProfileError.code} field to distinguish between error causes.
+ */
+export class ProfileError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'ProfileError';
+        this.code = code;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/profiles/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/profiles/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH;;;;GAIG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,IAAI,CAAmB;IAEhC,YAAY,IAAsB,EAAE,OAAe;QACjD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/profiles/index.browser.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Browser entry point for the profiles module.
+ *
+ * @packageDocumentation
+ */
+export { ProfileError } from './errors';
+export type { ProfileErrorCode } from './errors';
+export type { Profile, ResolveOptions } from './profile';
+export { Secret } from './secret';
+//# sourceMappingURL=index.browser.d.ts.map

package/dist/profiles/index.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../../src/profiles/index.browser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AACtC,YAAY,EAAC,gBAAgB,EAAC,MAAM,UAAU,CAAC;AAC/C,YAAY,EAAC,OAAO,EAAE,cAAc,EAAC,MAAM,WAAW,CAAC;AACvD,OAAO,EAAC,MAAM,EAAC,MAAM,UAAU,CAAC"}

package/dist/profiles/index.browser.js

@@ -0,0 +1,8 @@
+/**
+ * Browser entry point for the profiles module.
+ *
+ * @packageDocumentation
+ */
+export { ProfileError } from './errors';
+export { Secret } from './secret';
+//# sourceMappingURL=index.browser.js.map

package/dist/profiles/index.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.js","sourceRoot":"","sources":["../../src/profiles/index.browser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AAGtC,OAAO,EAAC,MAAM,EAAC,MAAM,UAAU,CAAC"}

package/dist/profiles/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Utility to resolve Databricks configuration profiles.
+ *
+ * A profile is a named collection of configuration values. It is typically
+ * stored in a file called ~/.databrickscfg. Profiles can be resolved from the
+ * file and/or environment variables using the {@link resolve} function.
+ *
+ * @packageDocumentation
+ */
+export { ProfileError } from './errors';
+export type { ProfileErrorCode } from './errors';
+export type { Profile, ResolveOptions } from './profile';
+export { defaultConfigFile, listProfiles, resolve } from './resolve';
+export { Secret } from './secret';
+//# sourceMappingURL=index.d.ts.map

package/dist/profiles/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/profiles/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AACtC,YAAY,EAAC,gBAAgB,EAAC,MAAM,UAAU,CAAC;AAC/C,YAAY,EAAC,OAAO,EAAE,cAAc,EAAC,MAAM,WAAW,CAAC;AACvD,OAAO,EAAC,iBAAiB,EAAE,YAAY,EAAE,OAAO,EAAC,MAAM,WAAW,CAAC;AACnE,OAAO,EAAC,MAAM,EAAC,MAAM,UAAU,CAAC"}

package/dist/profiles/index.js

@@ -0,0 +1,13 @@
+/**
+ * Utility to resolve Databricks configuration profiles.
+ *
+ * A profile is a named collection of configuration values. It is typically
+ * stored in a file called ~/.databrickscfg. Profiles can be resolved from the
+ * file and/or environment variables using the {@link resolve} function.
+ *
+ * @packageDocumentation
+ */
+export { ProfileError } from './errors';
+export { defaultConfigFile, listProfiles, resolve } from './resolve';
+export { Secret } from './secret';
+//# sourceMappingURL=index.js.map

package/dist/profiles/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/profiles/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AAGtC,OAAO,EAAC,iBAAiB,EAAE,YAAY,EAAE,OAAO,EAAC,MAAM,WAAW,CAAC;AACnE,OAAO,EAAC,MAAM,EAAC,MAAM,UAAU,CAAC"}

package/dist/profiles/ini.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Minimal INI parser and writer for the Databricks config file format.
+ *
+ * This matches the behavior of {@link https://pkg.go.dev/gopkg.in/ini.v1 | go-ini}
+ * with `SpaceBeforeInlineComment: true`, which is how the Go SDK loads
+ * databrickscfg files. Key behavioral details:
+ *
+ * - Inline comments are only recognized when `#` or `;` is preceded by a
+ *   space. The parser checks for `" #"` first; only if absent does it check
+ *   for `" ;"`. This matches Go's `strings.Index` precedence.
+ * - Both `=` and `:` are key-value delimiters (Go default). Only the first
+ *   delimiter on a line splits key from value.
+ * - Section names are the raw text between `[` and the last `]` on the line,
+ *   with no trimming.
+ * - Keys and values are trimmed of surrounding whitespace.
+ * - Lines without a delimiter throw an error (matching go-ini default).
+ *
+ * @module
+ */
+/** Parsed INI data as an ordered map of section names to key-value maps. */
+export type IniData = Map<string, Map<string, string>>;
+/**
+ * Parses an INI-formatted string into structured data.
+ *
+ * Keys before any section header are assigned to the "DEFAULT" section.
+ */
+export declare function parseIni(content: string): IniData;
+/**
+ * Formats structured INI data back into a string.
+ *
+ * Each section's keys are aligned so that all `=` signs appear in the same
+ * column, matching the output format of go-ini's `PrettyFormat` default.
+ * Sections are separated by blank lines (`PrettySection` default).
+ */
+export declare function formatIni(data: IniData): string;
+//# sourceMappingURL=ini.d.ts.map

package/dist/profiles/ini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ini.d.ts","sourceRoot":"","sources":["../../src/profiles/ini.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,4EAA4E;AAC5E,MAAM,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAsEjD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAkB/C"}

package/dist/profiles/ini.js

@@ -0,0 +1,113 @@
+/**
+ * Minimal INI parser and writer for the Databricks config file format.
+ *
+ * This matches the behavior of {@link https://pkg.go.dev/gopkg.in/ini.v1 | go-ini}
+ * with `SpaceBeforeInlineComment: true`, which is how the Go SDK loads
+ * databrickscfg files. Key behavioral details:
+ *
+ * - Inline comments are only recognized when `#` or `;` is preceded by a
+ *   space. The parser checks for `" #"` first; only if absent does it check
+ *   for `" ;"`. This matches Go's `strings.Index` precedence.
+ * - Both `=` and `:` are key-value delimiters (Go default). Only the first
+ *   delimiter on a line splits key from value.
+ * - Section names are the raw text between `[` and the last `]` on the line,
+ *   with no trimming.
+ * - Keys and values are trimmed of surrounding whitespace.
+ * - Lines without a delimiter throw an error (matching go-ini default).
+ *
+ * @module
+ */
+/**
+ * Parses an INI-formatted string into structured data.
+ *
+ * Keys before any section header are assigned to the "DEFAULT" section.
+ */
+export function parseIni(content) {
+    const result = new Map();
+    let currentSection = 'DEFAULT';
+    result.set(currentSection, new Map());
+    for (const rawLine of content.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        // Skip empty lines and full-line comments.
+        if (line === '' || line.startsWith('#') || line.startsWith(';')) {
+            continue;
+        }
+        // Section header: text between '[' and the last ']'.
+        if (line.startsWith('[')) {
+            const closeIdx = line.lastIndexOf(']');
+            if (closeIdx === -1) {
+                throw new Error(`unclosed section: ${line}`);
+            }
+            const name = line.slice(1, closeIdx);
+            if (name === '') {
+                throw new Error('empty section name');
+            }
+            currentSection = name;
+            if (!result.has(currentSection)) {
+                result.set(currentSection, new Map());
+            }
+            continue;
+        }
+        // Key-value pair: first '=' or ':' splits key from value.
+        const eqIdx = line.indexOf('=');
+        const colonIdx = line.indexOf(':');
+        let delimIdx;
+        if (eqIdx === -1 && colonIdx === -1) {
+            throw new Error(`key-value delimiter not found: ${line}`);
+        }
+        else if (eqIdx === -1) {
+            delimIdx = colonIdx;
+        }
+        else if (colonIdx === -1) {
+            delimIdx = eqIdx;
+        }
+        else {
+            delimIdx = Math.min(eqIdx, colonIdx);
+        }
+        const key = line.slice(0, delimIdx).trim();
+        if (key === '') {
+            throw new Error(`empty key name: ${line}`);
+        }
+        let value = line.slice(delimIdx + 1).trim();
+        // Strip inline comments matching go-ini's SpaceBeforeInlineComment
+        // precedence: try " #" first, then " ;" only if " #" is absent.
+        let commentIdx = value.indexOf(' #');
+        if (commentIdx === -1) {
+            commentIdx = value.indexOf(' ;');
+        }
+        if (commentIdx !== -1) {
+            value = value.slice(0, commentIdx).trimEnd();
+        }
+        if (!result.has(currentSection)) {
+            result.set(currentSection, new Map());
+        }
+        const section = result.get(currentSection);
+        if (section !== undefined) {
+            section.set(key, value);
+        }
+    }
+    return result;
+}
+/**
+ * Formats structured INI data back into a string.
+ *
+ * Each section's keys are aligned so that all `=` signs appear in the same
+ * column, matching the output format of go-ini's `PrettyFormat` default.
+ * Sections are separated by blank lines (`PrettySection` default).
+ */
+export function formatIni(data) {
+    const sections = [];
+    for (const [name, keys] of data) {
+        const lines = [];
+        lines.push(`[${name}]`);
+        if (keys.size > 0) {
+            const maxKeyLen = Math.max(...[...keys.keys()].map(k => k.length));
+            for (const [key, value] of keys) {
+                lines.push(`${key.padEnd(maxKeyLen)} = ${value}`);
+            }
+        }
+        sections.push(lines.join('\n'));
+    }
+    return sections.join('\n\n') + '\n';
+}
+//# sourceMappingURL=ini.js.map

package/dist/profiles/ini.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ini.js","sourceRoot":"","sources":["../../src/profiles/ini.ts"],"names":[],"mappings":"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"}

package/dist/profiles/profile.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Profile interface and property mapping for Databricks configuration.
+ *
+ * @module
+ */
+import { Secret } from './secret';
+/**
+ * Holds configuration values resolved from a databrickscfg file and/or
+ * environment variables. All fields are optional; an absent field means the
+ * value was not configured.
+ */
+export interface Profile {
+    /** Profile name (INI section name). */
+    name?: string;
+    /** Databricks workspace or Accounts API endpoint URL. */
+    host?: string;
+    /** Databricks Workspace ID, used with unified hosts. */
+    workspaceId?: string;
+    /** Databricks Account ID for Accounts API. */
+    accountId?: string;
+    /** Personal access token for PAT authentication. */
+    token?: Secret;
+    /** Username for basic authentication. */
+    username?: string;
+    /** Password for basic authentication. */
+    password?: Secret;
+    /** Selects a specific auth method when multiple credentials are available. */
+    authType?: string;
+    /** OAuth client ID for M2M authentication. */
+    clientId?: string;
+    /** OAuth client secret for M2M authentication. */
+    clientSecret?: Secret;
+    /** Path to the Databricks CLI binary (>= 0.100.0) for CLI-based auth. */
+    databricksCliPath?: string;
+    /** URL of a metadata service that provides authentication credentials. */
+    metadataServiceUrl?: Secret;
+    /** GitHub Actions URL for requesting an OIDC token. */
+    actionsIdTokenRequestUrl?: string;
+    /** Bearer token for the GitHub Actions OIDC provider. */
+    actionsIdTokenRequestToken?: Secret;
+    /** Name of an environment variable containing an OIDC ID token. */
+    oidcTokenEnv?: string;
+    /** Path to a file containing an OIDC ID token. */
+    oidcTokenFilePath?: string;
+    /** Audience for Workload Identity Federation ID token requests. */
+    tokenAudience?: string;
+    /** OpenID Connect discovery URL override. */
+    discoveryUrl?: string;
+    /** Azure AD application (client) ID. */
+    azureClientId?: string;
+    /** Azure AD client secret. */
+    azureClientSecret?: Secret;
+    /** Azure AD tenant ID. */
+    azureTenantId?: string;
+    /** Azure Resource Manager ID for an Azure Databricks workspace. */
+    azureResourceId?: string;
+    /** Azure cloud environment (PUBLIC, USGOVERNMENT, CHINA). */
+    azureEnvironment?: string;
+    /**
+     * Azure Login Application ID.
+     *
+     * @deprecated This field no longer has any effect.
+     */
+    azureLoginAppId?: string;
+    /** Whether to use Azure Managed Service Identity authentication. */
+    azureUseMsi?: boolean;
+    /** GCP service account credentials JSON. */
+    googleCredentials?: Secret;
+    /** GCP service account email for Google ID-based authentication. */
+    googleServiceAccount?: string;
+    /** Default Databricks cluster ID for compute operations. */
+    clusterId?: string;
+    /** Default Databricks SQL warehouse ID. */
+    warehouseId?: string;
+    /** Default serverless compute resource ID. */
+    serverlessComputeId?: string;
+    /**
+     * INI keys not mapped to a known field. Only populated when loading from a
+     * config file; environment variables do not contribute to extra.
+     */
+    extra?: Record<string, string>;
+}
+/** Configures the behavior of {@link resolve}. */
+export interface ResolveOptions {
+    /**
+     * Path to the databrickscfg file. If not set, reads
+     * DATABRICKS_CONFIG_FILE from the environment, falling back to
+     * ~/.databrickscfg. Setting this implies withFile: true.
+     */
+    filePath?: string;
+    /**
+     * Profile name (INI section) to load. If not set, resolves from the
+     * DATABRICKS_CONFIG_PROFILE environment variable, then the default_profile
+     * key in the __settings__ section, then falls back to the DEFAULT section.
+     * Setting this implies withFile: true.
+     */
+    profile?: string;
+    /** Whether to read from the config file. Default: true. */
+    withFile?: boolean;
+    /**
+     * Whether to overlay environment variables on top of config file values.
+     * When enabled, environment variables take precedence over file values.
+     * Default: true.
+     */
+    withEnv?: boolean;
+}
+/**
+ * Reserved INI section name for SDK settings. It is never treated as a
+ * profile.
+ */
+export declare const SETTINGS_SECTION = "__settings__";
+/**
+ * Maps a {@link Profile} field to its environment variable and INI key,
+ * with typed getter and setter closures. This avoids reflection while
+ * keeping the mapping declarative, matching the Go SDK's approach.
+ */
+export interface PropertyDef {
+    /** The Profile field name this property maps to. */
+    readonly field: keyof Profile;
+    readonly envVar: string;
+    readonly iniKey: string;
+    /** Sets the profile field from a raw INI/env string value. */
+    readonly set: (profile: Profile, raw: string) => void;
+    /** Returns the profile field as a string, or undefined if unset. */
+    readonly get: (profile: Profile) => string | undefined;
+}
+/**
+ * Declarative property mapping table for all known profile fields.
+ */
+export declare const PROPERTY_DEFS: readonly PropertyDef[];
+//# sourceMappingURL=profile.d.ts.map

package/dist/profiles/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../src/profiles/profile.ts"],"names":[],"mappings":"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"}