@databricks/sdk-core 0.1.0-dev.5 → 0.1.0-dev.7

package/src/ops/retrier.ts

@@ -1,108 +0,0 @@
-/** Options for configuring a {@link BackoffPolicy}. */
-export interface BackoffPolicyOptions {
-  /** Initial delay in milliseconds; defaults to 1000. */
-  initial?: number;
-
-  /** Maximum delay in milliseconds; defaults to 60000. */
-  maximum?: number;
-
-  /**
-   * Factor by which the delay is multiplied after each retry. The value must
-   * be greater or equal to 1. If not, it defaults to 2.
-   */
-  factor?: number;
-}
-
-// Random number generation, wrapped in an object for testability.
-export const rand = {
-  // Returns a random integer in [0, n).
-  int(n: number): number {
-    return Math.floor(Math.random() * n);
-  },
-};
-
-/**
- * BackoffPolicy implements an exponential backoff policy. The delay between
- * retries is randomly computed between 0 and the "exponential delay" as
- * recommended in [Exponential Backoff And Jitter]. The retry delay starts from
- * initial and grows exponentially by factor at every retry. The maximum retry
- * delay is capped by maximum.
- *
- * There is no parameter to limit the number of retries. This is intended as
- * such logic should be implemented upstream (e.g. in a Retrier).
- *
- * [Exponential Backoff And Jitter]: https://aws.amazon.com/blogs/architecture/exponential-backoff-and-jitter/
- */
-export class BackoffPolicy {
-  /** Initial delay in milliseconds. */
-  readonly initial: number;
-
-  /** Maximum delay in milliseconds. */
-  readonly maximum: number;
-
-  /** Factor by which the delay is multiplied after each retry. */
-  readonly factor: number;
-
-  // Current delay before the next retry.
-  private current: number;
-
-  constructor(options?: BackoffPolicyOptions) {
-    let initial = options?.initial ?? 1000; // Default initial delay of 1 second.
-    const maximum = options?.maximum ?? 60000; // Default maximum delay of 60 seconds.
-
-    if (initial > maximum) {
-      // Initial cannot be greater than maximum.
-      initial = maximum;
-    }
-
-    this.initial = initial;
-    this.maximum = maximum;
-    this.factor =
-      options?.factor !== undefined && options.factor >= 1 ? options.factor : 2;
-    this.current = this.initial;
-  }
-
-  /** Returns a random delay in [0, current] and grows the current delay. */
-  delay(): number {
-    // Random duration in the range [0, this.current].
-    const d = rand.int(this.current + 1);
-
-    // Grow delay for the next call.
-    this.current = Math.min(this.current * this.factor, this.maximum);
-
-    return d;
-  }
-}
-
-/** Retrier defines a retry behavior. */
-export interface Retrier {
-  /**
-   * Returns the delay in milliseconds before the next retry, or undefined if
-   * the error is not retriable. Implementations should assume that the given
-   * error is never undefined.
-   */
-  isRetriable(err: Error): number | undefined;
-}
-
-/**
- * Returns a Retrier that retries based on the isRetriable predicate and relies
- * on an internal backoff policy to decide how long to wait between retries.
- *
- * Important: the retrier has its own backoff policy which cannot be trivially
- * reset by design. Users who need to reset the backoff policy should rather
- * create a new retrier.
- */
-export function retryOn(
-  options: BackoffPolicyOptions,
-  isRetriable: (err: Error) => boolean
-): Retrier {
-  const bp = new BackoffPolicy(options);
-  return {
-    isRetriable(err: Error): number | undefined {
-      if (!isRetriable(err)) {
-        return undefined;
-      }
-      return bp.delay();
-    },
-  };
-}

package/src/profiles/errors.ts

@@ -1,28 +0,0 @@
-/**
- * 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 class ProfileError extends Error {
-  readonly code: ProfileErrorCode;
-
-  constructor(code: ProfileErrorCode, message: string) {
-    super(message);
-    this.name = 'ProfileError';
-    this.code = code;
-  }
-}

package/src/profiles/index.browser.ts

@@ -1,10 +0,0 @@
-/**
- * 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';

package/src/profiles/index.ts

@@ -1,15 +0,0 @@
-/**
- * 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';

package/src/profiles/ini.ts

@@ -1,126 +0,0 @@
-/**
- * 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 function parseIni(content: string): IniData {
-  const result: IniData = 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: number;
-    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: IniData): string {
-  const sections: string[] = [];
-
-  for (const [name, keys] of data) {
-    const lines: string[] = [];
-    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';
-}