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

package/dist/apierror/apierror.js

@@ -0,0 +1,217 @@
+import { z } from 'zod';
+import { Code, codeFromString } from './codes';
+import { parseErrorDetails } from './details';
+// Reusable schema fragment for nullish string fields.
+const nullishString = z
+    .string()
+    .nullish()
+    .transform(v => v ?? '');
+// Zod schema for parsing the JSON error response body. The schema is lenient
+// to handle the various Databricks API error formats (standard, legacy, SCIM).
+const errorResponseSchema = z.object({
+    message: nullishString,
+    details: z
+        .array(z.unknown())
+        .nullish()
+        .transform(v => v ?? []),
+    // Some Databricks APIs incorrectly return the HTTP status code as an
+    // integer rather than the actual error code as a string.
+    error_code: z.unknown().optional(),
+    // Legacy Databricks APIs (e.g. version 1.2 and earlier) used "error"
+    // instead of "message".
+    error: nullishString,
+    // SCIM error fields (RFC7644 section 3.7.3).
+    // The "status" field is intentionally omitted; it duplicates HTTP status.
+    detail: nullishString,
+    scimType: nullishString,
+});
+/** ApiError is a transport-agnostic error representing a Databricks API error. */
+export class ApiError extends Error {
+    /** The canonical error code of the error. */
+    code;
+    /**
+     * The structured error details of the error. This is left empty if the
+     * error response is not a standard Databricks API error.
+     */
+    details;
+    // The raw HTTP error details, undefined if this is not an HTTP error.
+    httpErr;
+    /**
+     * Do not use this constructor directly. Use {@link ApiError.fromHttpError}
+     * instead. This constructor is only meant for internal and testing use.
+     * TODO: Make this constructor private.
+     *
+     * @private
+     */
+    constructor(options) {
+        super(options.message, { cause: options.cause });
+        this.name = 'ApiError';
+        this.code = options.code;
+        this.details = options.details;
+        if (options.httpStatusCode !== undefined) {
+            this.httpErr = {
+                statusCode: options.httpStatusCode,
+                header: options.httpHeader,
+                body: options.httpBody,
+            };
+        }
+    }
+    /**
+     * Returns the ApiError's HTTP status code. If the ApiError is not an HTTP
+     * error, returns -1.
+     */
+    get httpStatusCode() {
+        if (this.httpErr === undefined) {
+            return -1;
+        }
+        return this.httpErr.statusCode;
+    }
+    /**
+     * Returns the ApiError's HTTP headers. If the ApiError is not an HTTP
+     * error, returns undefined.
+     */
+    get httpHeader() {
+        if (this.httpErr === undefined) {
+            return undefined;
+        }
+        return this.httpErr.header;
+    }
+    /**
+     * Returns the ApiError's HTTP body. If the ApiError is not an HTTP error,
+     * returns undefined.
+     */
+    get httpBody() {
+        if (this.httpErr === undefined) {
+            return undefined;
+        }
+        return this.httpErr.body;
+    }
+    /**
+     * Parses an HTTP error response into an ApiError. Returns undefined if the
+     * status code is 2xx.
+     */
+    static fromHttpError(statusCode, header, body) {
+        if (statusCode >= 200 && statusCode < 300) {
+            return undefined;
+        }
+        const emptyDetails = { unknownDetails: [] };
+        if (body === undefined || body.length === 0) {
+            return new ApiError({
+                code: toCode(statusCode),
+                message: '',
+                details: emptyDetails,
+                httpStatusCode: statusCode,
+                httpHeader: header,
+                httpBody: body,
+            });
+        }
+        // Decode the body to a string for JSON parsing.
+        let parsed;
+        try {
+            parsed = JSON.parse(new TextDecoder().decode(body));
+        }
+        catch (e) {
+            // The JSON error is simply swallowed, this typically happens when the
+            // error does not come directly from a Databricks API. A typical example
+            // is when the error is returned by a proxy.
+            return new ApiError({
+                code: toCode(statusCode),
+                message: '',
+                details: emptyDetails,
+                httpStatusCode: statusCode,
+                httpHeader: header,
+                httpBody: body,
+                cause: e instanceof Error ? e : undefined,
+            });
+        }
+        const result = errorResponseSchema.safeParse(parsed);
+        if (!result.success) {
+            return new ApiError({
+                code: toCode(statusCode),
+                message: '',
+                details: emptyDetails,
+                httpStatusCode: statusCode,
+                httpHeader: header,
+                httpBody: body,
+                cause: result.error,
+            });
+        }
+        const errResp = result.data;
+        // Error codes may be missing or be an integer (legacy APIs). In such
+        // cases, defer to the HTTP status code to infer the closest canonical
+        // error code.
+        let errorCode;
+        if (typeof errResp.error_code === 'string') {
+            errorCode = codeFromString(errResp.error_code);
+        }
+        else {
+            errorCode = toCode(statusCode);
+        }
+        // Determine the error message from available fields.
+        let errorMessage = '';
+        if (errResp.message !== '') {
+            errorMessage = errResp.message;
+        }
+        else if (errResp.error !== '') {
+            errorMessage = errResp.error;
+        }
+        else if (errResp.detail !== '') {
+            errorMessage = errResp.detail;
+        }
+        else if (errResp.scimType !== '') {
+            errorMessage = errResp.scimType;
+        }
+        return new ApiError({
+            code: errorCode,
+            message: errorMessage,
+            details: parseErrorDetails(errResp.details),
+            httpStatusCode: statusCode,
+            httpHeader: header,
+            httpBody: body,
+        });
+    }
+}
+// Maps an HTTP status code to the closest canonical error code.
+export function toCode(httpCode) {
+    // Canonical mappings.
+    switch (httpCode) {
+        case 200:
+            return Code.OK;
+        case 400:
+            return Code.INVALID_ARGUMENT;
+        case 401:
+            return Code.UNAUTHENTICATED;
+        case 403:
+            return Code.PERMISSION_DENIED;
+        case 404:
+            return Code.NOT_FOUND;
+        case 409:
+            return Code.ABORTED;
+        case 416:
+            return Code.OUT_OF_RANGE;
+        case 429:
+            return Code.RESOURCE_EXHAUSTED;
+        case 501:
+            return Code.UNIMPLEMENTED;
+        case 503:
+            return Code.UNAVAILABLE;
+        case 504:
+            return Code.DEADLINE_EXCEEDED;
+        default:
+            break;
+    }
+    // Fallback for status codes without a direct canonical mapping.
+    if (httpCode >= 200 && httpCode < 300) {
+        return Code.OK;
+    }
+    if (httpCode >= 400 && httpCode < 500) {
+        // Most non-canonical 4xx status codes are state related and map
+        // to the definition of FailedPrecondition.
+        return Code.FAILED_PRECONDITION;
+    }
+    if (httpCode >= 500 && httpCode < 600) {
+        return Code.INTERNAL;
+    }
+    return Code.UNKNOWN;
+}
+//# sourceMappingURL=apierror.js.map

package/dist/apierror/apierror.js.map

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

package/dist/apierror/codes/codes.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Defines error codes for API errors and their retry semantics.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Code is a numeric code for an error.
+ *
+ * The numeric values are stable and can be relied upon across SDK versions.
+ */
+declare enum Code {
+    /**
+     * Unknown indicates an error that cannot be classified.
+     *
+     * This code might be used for malformed error responses or error responses
+     * using an error code that cannot be mapped to a code in this package.
+     */
+    UNKNOWN = 0,
+    /** OK indicates the operation completed successfully. */
+    OK = 1,
+    /** Canceled indicates the operation was canceled (typically by the caller). */
+    CANCELED = 2,
+    /**
+     * InvalidArgument indicates the client specified an invalid argument.
+     *
+     * By contrast with FailedPrecondition, InvalidArgument indicates arguments
+     * that are problematic regardless of the state of the system. For example,
+     * a malformed request parameter.
+     */
+    INVALID_ARGUMENT = 3,
+    /**
+     * DeadlineExceeded means the operation expired before completion.
+     *
+     * For operations that modify the state of the system, this error may be
+     * returned even if the operation has completed successfully. For
+     * example, a successful response from a server could have been delayed
+     * long enough for the deadline to expire.
+     */
+    DEADLINE_EXCEEDED = 4,
+    /**
+     * NotFound means a requested entity (e.g. a resource or a file) was
+     * not found.
+     */
+    NOT_FOUND = 5,
+    /**
+     * AlreadyExists means an attempt to create an entity failed because one
+     * already exists.
+     */
+    ALREADY_EXISTS = 6,
+    /**
+     * PermissionDenied indicates the caller does not have permission to
+     * execute the specified operation.
+     *
+     * This is different from an error returned when the user has exhausted
+     * some resource (e.g. too many requests) which is a ResourceExhausted
+     * error.
+     */
+    PERMISSION_DENIED = 7,
+    /**
+     * ResourceExhausted indicates some resource has been exhausted, perhaps
+     * a per-user quota, or perhaps the entire file system is out of space.
+     */
+    RESOURCE_EXHAUSTED = 8,
+    /**
+     * FailedPrecondition indicates the operation was rejected because the
+     * system is not in a state required for the operation's execution.
+     * For example, directory to be deleted may be non-empty, an rmdir
+     * operation is applied to a non-directory, etc.
+     */
+    FAILED_PRECONDITION = 9,
+    /**
+     * Aborted indicates the operation was aborted, typically due to a
+     * concurrency issue like sequencer check failures, transaction aborts,
+     * etc.
+     */
+    ABORTED = 10,
+    /**
+     * OutOfRange means the operation was attempted past the valid range.
+     * E.g., seeking or reading past end of file.
+     *
+     * Unlike InvalidArgument, this error indicates a problem that may
+     * be fixed if the system state changes. For example, a 32-bit file
+     * system will generate InvalidArgument if asked to read at an
+     * offset that is not in the range [0,2^32-1], but it will generate
+     * OutOfRange if asked to read from an offset past the current
+     * file size.
+     *
+     * There is a fair bit of overlap between FailedPrecondition and
+     * OutOfRange. We recommend using OutOfRange (the more specific
+     * error) when it applies so that callers who are iterating through
+     * a space can easily look for an OutOfRange error to detect when
+     * they are done.
+     */
+    OUT_OF_RANGE = 11,
+    /**
+     * Unimplemented indicates the operation is not implemented or not
+     * supported/enabled in this service.
+     */
+    UNIMPLEMENTED = 12,
+    /**
+     * Internal indicates an internal error. This means some invariants
+     * expected by the underlying system have been broken. If you see
+     * this error, something is very broken.
+     */
+    INTERNAL = 13,
+    /**
+     * Unavailable indicates the service is currently unavailable.
+     *
+     * This is most likely a transient condition and may be corrected by
+     * retrying. Though, this might not always be safe to retry if the
+     * operation is non-idempotent.
+     *
+     * The Databricks SDK will generally automatically retry the request
+     * with a backoff when encountering this error.
+     */
+    UNAVAILABLE = 14,
+    /** DataLoss indicates unrecoverable data loss or corruption. */
+    DATA_LOSS = 15,
+    /**
+     * Unauthenticated indicates the request does not have valid
+     * authentication credentials for the operation.
+     */
+    UNAUTHENTICATED = 16
+}
+/**
+ * Returns the canonical string representation of an error code.
+ *
+ * If the code is not recognized, "UNKNOWN" is returned. Note that
+ * Code.CANCELED maps to "CANCELLED" (British spelling) to match the gRPC
+ * convention.
+ */
+declare function codeToString(code: Code): string;
+/**
+ * Converts a string representation of an error code to its corresponding
+ * Code value. If the string does not match any known code, Code.UNKNOWN is
+ * returned.
+ */
+declare function codeFromString(s: string): Code;
+export { Code, codeToString, codeFromString };
+//# sourceMappingURL=codes.d.ts.map

package/dist/apierror/codes/codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../../../src/apierror/codes/codes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,aAAK,IAAI;IACP;;;;;OAKG;IACH,OAAO,IAAI;IAEX,yDAAyD;IACzD,EAAE,IAAI;IAEN,+EAA+E;IAC/E,QAAQ,IAAI;IAEZ;;;;;;OAMG;IACH,gBAAgB,IAAI;IAEpB;;;;;;;OAOG;IACH,iBAAiB,IAAI;IAErB;;;OAGG;IACH,SAAS,IAAI;IAEb;;;OAGG;IACH,cAAc,IAAI;IAElB;;;;;;;OAOG;IACH,iBAAiB,IAAI;IAErB;;;OAGG;IACH,kBAAkB,IAAI;IAEtB;;;;;OAKG;IACH,mBAAmB,IAAI;IAEvB;;;;OAIG;IACH,OAAO,KAAK;IAEZ;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,KAAK;IAEjB;;;OAGG;IACH,aAAa,KAAK;IAElB;;;;OAIG;IACH,QAAQ,KAAK;IAEb;;;;;;;;;OASG;IACH,WAAW,KAAK;IAEhB,gEAAgE;IAChE,SAAS,KAAK;IAEd;;;OAGG;IACH,eAAe,KAAK;CACrB;AA4BD;;;;;;GAMG;AACH,iBAAS,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAExC;AAED;;;;GAIG;AACH,iBAAS,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAEvC;AAED,OAAO,EAAC,IAAI,EAAE,YAAY,EAAE,cAAc,EAAC,CAAC"}

package/dist/apierror/codes/codes.js

@@ -0,0 +1,167 @@
+/**
+ * Defines error codes for API errors and their retry semantics.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Code is a numeric code for an error.
+ *
+ * The numeric values are stable and can be relied upon across SDK versions.
+ */
+var Code;
+(function (Code) {
+    /**
+     * Unknown indicates an error that cannot be classified.
+     *
+     * This code might be used for malformed error responses or error responses
+     * using an error code that cannot be mapped to a code in this package.
+     */
+    Code[Code["UNKNOWN"] = 0] = "UNKNOWN";
+    /** OK indicates the operation completed successfully. */
+    Code[Code["OK"] = 1] = "OK";
+    /** Canceled indicates the operation was canceled (typically by the caller). */
+    Code[Code["CANCELED"] = 2] = "CANCELED";
+    /**
+     * InvalidArgument indicates the client specified an invalid argument.
+     *
+     * By contrast with FailedPrecondition, InvalidArgument indicates arguments
+     * that are problematic regardless of the state of the system. For example,
+     * a malformed request parameter.
+     */
+    Code[Code["INVALID_ARGUMENT"] = 3] = "INVALID_ARGUMENT";
+    /**
+     * DeadlineExceeded means the operation expired before completion.
+     *
+     * For operations that modify the state of the system, this error may be
+     * returned even if the operation has completed successfully. For
+     * example, a successful response from a server could have been delayed
+     * long enough for the deadline to expire.
+     */
+    Code[Code["DEADLINE_EXCEEDED"] = 4] = "DEADLINE_EXCEEDED";
+    /**
+     * NotFound means a requested entity (e.g. a resource or a file) was
+     * not found.
+     */
+    Code[Code["NOT_FOUND"] = 5] = "NOT_FOUND";
+    /**
+     * AlreadyExists means an attempt to create an entity failed because one
+     * already exists.
+     */
+    Code[Code["ALREADY_EXISTS"] = 6] = "ALREADY_EXISTS";
+    /**
+     * PermissionDenied indicates the caller does not have permission to
+     * execute the specified operation.
+     *
+     * This is different from an error returned when the user has exhausted
+     * some resource (e.g. too many requests) which is a ResourceExhausted
+     * error.
+     */
+    Code[Code["PERMISSION_DENIED"] = 7] = "PERMISSION_DENIED";
+    /**
+     * ResourceExhausted indicates some resource has been exhausted, perhaps
+     * a per-user quota, or perhaps the entire file system is out of space.
+     */
+    Code[Code["RESOURCE_EXHAUSTED"] = 8] = "RESOURCE_EXHAUSTED";
+    /**
+     * FailedPrecondition indicates the operation was rejected because the
+     * system is not in a state required for the operation's execution.
+     * For example, directory to be deleted may be non-empty, an rmdir
+     * operation is applied to a non-directory, etc.
+     */
+    Code[Code["FAILED_PRECONDITION"] = 9] = "FAILED_PRECONDITION";
+    /**
+     * Aborted indicates the operation was aborted, typically due to a
+     * concurrency issue like sequencer check failures, transaction aborts,
+     * etc.
+     */
+    Code[Code["ABORTED"] = 10] = "ABORTED";
+    /**
+     * OutOfRange means the operation was attempted past the valid range.
+     * E.g., seeking or reading past end of file.
+     *
+     * Unlike InvalidArgument, this error indicates a problem that may
+     * be fixed if the system state changes. For example, a 32-bit file
+     * system will generate InvalidArgument if asked to read at an
+     * offset that is not in the range [0,2^32-1], but it will generate
+     * OutOfRange if asked to read from an offset past the current
+     * file size.
+     *
+     * There is a fair bit of overlap between FailedPrecondition and
+     * OutOfRange. We recommend using OutOfRange (the more specific
+     * error) when it applies so that callers who are iterating through
+     * a space can easily look for an OutOfRange error to detect when
+     * they are done.
+     */
+    Code[Code["OUT_OF_RANGE"] = 11] = "OUT_OF_RANGE";
+    /**
+     * Unimplemented indicates the operation is not implemented or not
+     * supported/enabled in this service.
+     */
+    Code[Code["UNIMPLEMENTED"] = 12] = "UNIMPLEMENTED";
+    /**
+     * Internal indicates an internal error. This means some invariants
+     * expected by the underlying system have been broken. If you see
+     * this error, something is very broken.
+     */
+    Code[Code["INTERNAL"] = 13] = "INTERNAL";
+    /**
+     * Unavailable indicates the service is currently unavailable.
+     *
+     * This is most likely a transient condition and may be corrected by
+     * retrying. Though, this might not always be safe to retry if the
+     * operation is non-idempotent.
+     *
+     * The Databricks SDK will generally automatically retry the request
+     * with a backoff when encountering this error.
+     */
+    Code[Code["UNAVAILABLE"] = 14] = "UNAVAILABLE";
+    /** DataLoss indicates unrecoverable data loss or corruption. */
+    Code[Code["DATA_LOSS"] = 15] = "DATA_LOSS";
+    /**
+     * Unauthenticated indicates the request does not have valid
+     * authentication credentials for the operation.
+     */
+    Code[Code["UNAUTHENTICATED"] = 16] = "UNAUTHENTICATED";
+})(Code || (Code = {}));
+// Maps Code values to their canonical string representation.
+const CODE_TO_STRING = new Map([
+    [Code.UNKNOWN, 'UNKNOWN'],
+    [Code.OK, 'OK'],
+    [Code.CANCELED, 'CANCELLED'],
+    [Code.INVALID_ARGUMENT, 'INVALID_ARGUMENT'],
+    [Code.DEADLINE_EXCEEDED, 'DEADLINE_EXCEEDED'],
+    [Code.NOT_FOUND, 'NOT_FOUND'],
+    [Code.ALREADY_EXISTS, 'ALREADY_EXISTS'],
+    [Code.PERMISSION_DENIED, 'PERMISSION_DENIED'],
+    [Code.RESOURCE_EXHAUSTED, 'RESOURCE_EXHAUSTED'],
+    [Code.FAILED_PRECONDITION, 'FAILED_PRECONDITION'],
+    [Code.ABORTED, 'ABORTED'],
+    [Code.OUT_OF_RANGE, 'OUT_OF_RANGE'],
+    [Code.UNIMPLEMENTED, 'UNIMPLEMENTED'],
+    [Code.INTERNAL, 'INTERNAL'],
+    [Code.UNAVAILABLE, 'UNAVAILABLE'],
+    [Code.DATA_LOSS, 'DATA_LOSS'],
+    [Code.UNAUTHENTICATED, 'UNAUTHENTICATED'],
+]);
+// Maps canonical strings back to Code values.
+const STRING_TO_CODE = new Map([...CODE_TO_STRING.entries()].map(([code, str]) => [str, code]));
+/**
+ * Returns the canonical string representation of an error code.
+ *
+ * If the code is not recognized, "UNKNOWN" is returned. Note that
+ * Code.CANCELED maps to "CANCELLED" (British spelling) to match the gRPC
+ * convention.
+ */
+function codeToString(code) {
+    return CODE_TO_STRING.get(code) ?? 'UNKNOWN';
+}
+/**
+ * Converts a string representation of an error code to its corresponding
+ * Code value. If the string does not match any known code, Code.UNKNOWN is
+ * returned.
+ */
+function codeFromString(s) {
+    return STRING_TO_CODE.get(s) ?? Code.UNKNOWN;
+}
+export { Code, codeToString, codeFromString };
+//# sourceMappingURL=codes.js.map

package/dist/apierror/codes/codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codes.js","sourceRoot":"","sources":["../../../src/apierror/codes/codes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,IAAK,IAiIJ;AAjID,WAAK,IAAI;IACP;;;;;OAKG;IACH,qCAAW,CAAA;IAEX,yDAAyD;IACzD,2BAAM,CAAA;IAEN,+EAA+E;IAC/E,uCAAY,CAAA;IAEZ;;;;;;OAMG;IACH,uDAAoB,CAAA;IAEpB;;;;;;;OAOG;IACH,yDAAqB,CAAA;IAErB;;;OAGG;IACH,yCAAa,CAAA;IAEb;;;OAGG;IACH,mDAAkB,CAAA;IAElB;;;;;;;OAOG;IACH,yDAAqB,CAAA;IAErB;;;OAGG;IACH,2DAAsB,CAAA;IAEtB;;;;;OAKG;IACH,6DAAuB,CAAA;IAEvB;;;;OAIG;IACH,sCAAY,CAAA;IAEZ;;;;;;;;;;;;;;;;OAgBG;IACH,gDAAiB,CAAA;IAEjB;;;OAGG;IACH,kDAAkB,CAAA;IAElB;;;;OAIG;IACH,wCAAa,CAAA;IAEb;;;;;;;;;OASG;IACH,8CAAgB,CAAA;IAEhB,gEAAgE;IAChE,0CAAc,CAAA;IAEd;;;OAGG;IACH,sDAAoB,CAAA;AACtB,CAAC,EAjII,IAAI,KAAJ,IAAI,QAiIR;AAED,6DAA6D;AAC7D,MAAM,cAAc,GAA8B,IAAI,GAAG,CAAC;IACxD,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC;IACzB,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC;IACf,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC5B,CAAC,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,CAAC;IAC3C,CAAC,IAAI,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;IAC7C,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC;IAC7B,CAAC,IAAI,CAAC,cAAc,EAAE,gBAAgB,CAAC;IACvC,CAAC,IAAI,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;IAC7C,CAAC,IAAI,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;IAC/C,CAAC,IAAI,CAAC,mBAAmB,EAAE,qBAAqB,CAAC;IACjD,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC;IACzB,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC;IACnC,CAAC,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC;IACrC,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC3B,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC;IACjC,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC;IAC7B,CAAC,IAAI,CAAC,eAAe,EAAE,iBAAiB,CAAC;CAC1C,CAAC,CAAC;AAEH,8CAA8C;AAC9C,MAAM,cAAc,GAA8B,IAAI,GAAG,CACvD,CAAC,GAAG,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAChE,CAAC;AAEF;;;;;;GAMG;AACH,SAAS,YAAY,CAAC,IAAU;IAC9B,OAAO,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,CAAS;IAC/B,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC;AAC/C,CAAC;AAED,OAAO,EAAC,IAAI,EAAE,YAAY,EAAE,cAAc,EAAC,CAAC"}

package/dist/apierror/codes/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Canonical error codes for Databricks API errors.
+ *
+ * @packageDocumentation
+ */
+export { Code, codeToString, codeFromString } from './codes';
+//# sourceMappingURL=index.d.ts.map

package/dist/apierror/codes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/apierror/codes/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,IAAI,EAAE,YAAY,EAAE,cAAc,EAAC,MAAM,SAAS,CAAC"}

package/dist/apierror/codes/index.js

@@ -0,0 +1,7 @@
+/**
+ * Canonical error codes for Databricks API errors.
+ *
+ * @packageDocumentation
+ */
+export { Code, codeToString, codeFromString } from './codes';
+//# sourceMappingURL=index.js.map

package/dist/apierror/codes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/apierror/codes/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,IAAI,EAAE,YAAY,EAAE,cAAc,EAAC,MAAM,SAAS,CAAC"}