@databricks/appkit 0.1.4 → 0.2.0

package/dist/errors/base.d.ts

@@ -0,0 +1,58 @@
+//#region src/errors/base.d.ts
+/**
+ * Base error class for all AppKit errors.
+ * Provides a consistent structure for error handling across the framework.
+ *
+ * @example
+ * ```typescript
+ * // Catching errors by type
+ * try {
+ *   await lakebase.query("...");
+ * } catch (e) {
+ *   if (e instanceof AuthenticationError) {
+ *     // Re-authenticate
+ *   } else if (e instanceof ConnectionError && e.isRetryable) {
+ *     // Retry with backoff
+ *   }
+ * }
+ *
+ * // Logging errors
+ * console.error(error.toJSON()); // Safe for logging, sensitive values redacted
+ * ```
+ */
+declare abstract class AppKitError extends Error {
+  /** Error code for programmatic error handling */
+  abstract readonly code: string;
+  /** HTTP status code suggestion (can be overridden) */
+  abstract readonly statusCode: number;
+  /** Whether this error type is generally safe to retry */
+  abstract readonly isRetryable: boolean;
+  /** Optional cause of the error */
+  readonly cause?: Error;
+  /** Additional context for the error */
+  readonly context?: Record<string, unknown>;
+  constructor(message: string, options?: {
+    cause?: Error;
+    context?: Record<string, unknown>;
+  });
+  /**
+   * Convert error to JSON for logging/serialization.
+   * Sensitive values in context are automatically redacted.
+   */
+  toJSON(): Record<string, unknown>;
+  /**
+   * Create a human-readable string representation
+   */
+  toString(): string;
+  /**
+   * Sanitize context by redacting sensitive field values
+   */
+  private sanitizeContext;
+  /**
+   * Check if a field name matches sensitive patterns
+   */
+  private isSensitiveField;
+}
+//#endregion
+export { AppKitError };
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","names":[],"sources":["../../src/errors/base.ts"],"sourcesContent":[],"mappings":";;AAgCA;;;;;;;;;;;;;;;;;;;;uBAAsB,WAAA,SAAoB,KAAA;;;;;;;;mBAWvB;;qBAGE;;YAIG;cAAiB;;;;;;YAiB7B"}

package/dist/errors/base.js

@@ -0,0 +1,70 @@
+import { __esmMin } from "../_virtual/rolldown_runtime.js";
+
+//#region src/errors/base.ts
+var SENSITIVE_FIELD_PATTERNS, AppKitError;
+var init_base = __esmMin((() => {
+	SENSITIVE_FIELD_PATTERNS = [
+		/token/i,
+		/password/i,
+		/secret/i,
+		/credential/i,
+		/auth/i,
+		/key$/i,
+		/apikey/i
+	];
+	AppKitError = class extends Error {
+		constructor(message, options) {
+			super(message);
+			this.name = this.constructor.name;
+			this.cause = options?.cause;
+			this.context = options?.context;
+			if (Error.captureStackTrace) Error.captureStackTrace(this, this.constructor);
+		}
+		/**
+		* Convert error to JSON for logging/serialization.
+		* Sensitive values in context are automatically redacted.
+		*/
+		toJSON() {
+			return {
+				name: this.name,
+				code: this.code,
+				message: this.message,
+				statusCode: this.statusCode,
+				isRetryable: this.isRetryable,
+				context: this.sanitizeContext(this.context),
+				cause: this.cause?.message,
+				stack: this.stack
+			};
+		}
+		/**
+		* Create a human-readable string representation
+		*/
+		toString() {
+			let str = `${this.name} [${this.code}]: ${this.message}`;
+			if (this.cause) str += ` (caused by: ${this.cause.message})`;
+			return str;
+		}
+		/**
+		* Sanitize context by redacting sensitive field values
+		*/
+		sanitizeContext(context) {
+			if (!context) return void 0;
+			const sanitized = {};
+			for (const [key, value] of Object.entries(context)) if (this.isSensitiveField(key)) sanitized[key] = "[REDACTED]";
+			else if (typeof value === "object" && value !== null) sanitized[key] = Array.isArray(value) ? `[Array(${value.length})]` : "[Object]";
+			else sanitized[key] = value;
+			return sanitized;
+		}
+		/**
+		* Check if a field name matches sensitive patterns
+		*/
+		isSensitiveField(fieldName) {
+			return SENSITIVE_FIELD_PATTERNS.some((pattern) => pattern.test(fieldName));
+		}
+	};
+}));
+
+//#endregion
+init_base();
+export { AppKitError, init_base };
+//# sourceMappingURL=base.js.map

package/dist/errors/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","names":[],"sources":["../../src/errors/base.ts"],"sourcesContent":["/** Fields that should be redacted in logs/serialization for security */\nconst SENSITIVE_FIELD_PATTERNS = [\n  /token/i,\n  /password/i,\n  /secret/i,\n  /credential/i,\n  /auth/i,\n  /key$/i,\n  /apikey/i,\n];\n\n/**\n * Base error class for all AppKit errors.\n * Provides a consistent structure for error handling across the framework.\n *\n * @example\n * ```typescript\n * // Catching errors by type\n * try {\n *   await lakebase.query(\"...\");\n * } catch (e) {\n *   if (e instanceof AuthenticationError) {\n *     // Re-authenticate\n *   } else if (e instanceof ConnectionError && e.isRetryable) {\n *     // Retry with backoff\n *   }\n * }\n *\n * // Logging errors\n * console.error(error.toJSON()); // Safe for logging, sensitive values redacted\n * ```\n */\nexport abstract class AppKitError extends Error {\n  /** Error code for programmatic error handling */\n  abstract readonly code: string;\n\n  /** HTTP status code suggestion (can be overridden) */\n  abstract readonly statusCode: number;\n\n  /** Whether this error type is generally safe to retry */\n  abstract readonly isRetryable: boolean;\n\n  /** Optional cause of the error */\n  readonly cause?: Error;\n\n  /** Additional context for the error */\n  readonly context?: Record<string, unknown>;\n\n  constructor(\n    message: string,\n    options?: { cause?: Error; context?: Record<string, unknown> },\n  ) {\n    super(message);\n    this.name = this.constructor.name;\n    this.cause = options?.cause;\n    this.context = options?.context;\n\n    // Maintains proper stack trace for where the error was thrown\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n\n  /**\n   * Convert error to JSON for logging/serialization.\n   * Sensitive values in context are automatically redacted.\n   */\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      code: this.code,\n      message: this.message,\n      statusCode: this.statusCode,\n      isRetryable: this.isRetryable,\n      context: this.sanitizeContext(this.context),\n      cause: this.cause?.message,\n      stack: this.stack,\n    };\n  }\n\n  /**\n   * Create a human-readable string representation\n   */\n  toString(): string {\n    let str = `${this.name} [${this.code}]: ${this.message}`;\n    if (this.cause) {\n      str += ` (caused by: ${this.cause.message})`;\n    }\n    return str;\n  }\n\n  /**\n   * Sanitize context by redacting sensitive field values\n   */\n  private sanitizeContext(\n    context?: Record<string, unknown>,\n  ): Record<string, unknown> | undefined {\n    if (!context) return undefined;\n\n    const sanitized: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(context)) {\n      if (this.isSensitiveField(key)) {\n        sanitized[key] = \"[REDACTED]\";\n      } else if (typeof value === \"object\" && value !== null) {\n        // Don't deep-sanitize nested objects, just indicate their type\n        sanitized[key] = Array.isArray(value)\n          ? `[Array(${value.length})]`\n          : \"[Object]\";\n      } else {\n        sanitized[key] = value;\n      }\n    }\n    return sanitized;\n  }\n\n  /**\n   * Check if a field name matches sensitive patterns\n   */\n  private isSensitiveField(fieldName: string): boolean {\n    return SENSITIVE_FIELD_PATTERNS.some((pattern) => pattern.test(fieldName));\n  }\n}\n"],"mappings":";;;;;CACM,2BAA2B;EAC/B;EACA;EACA;EACA;EACA;EACA;EACA;EACD;CAuBqB,cAAtB,cAA0C,MAAM;EAgB9C,YACE,SACA,SACA;AACA,SAAM,QAAQ;AACd,QAAK,OAAO,KAAK,YAAY;AAC7B,QAAK,QAAQ,SAAS;AACtB,QAAK,UAAU,SAAS;AAGxB,OAAI,MAAM,kBACR,OAAM,kBAAkB,MAAM,KAAK,YAAY;;;;;;EAQnD,SAAkC;AAChC,UAAO;IACL,MAAM,KAAK;IACX,MAAM,KAAK;IACX,SAAS,KAAK;IACd,YAAY,KAAK;IACjB,aAAa,KAAK;IAClB,SAAS,KAAK,gBAAgB,KAAK,QAAQ;IAC3C,OAAO,KAAK,OAAO;IACnB,OAAO,KAAK;IACb;;;;;EAMH,WAAmB;GACjB,IAAI,MAAM,GAAG,KAAK,KAAK,IAAI,KAAK,KAAK,KAAK,KAAK;AAC/C,OAAI,KAAK,MACP,QAAO,gBAAgB,KAAK,MAAM,QAAQ;AAE5C,UAAO;;;;;EAMT,AAAQ,gBACN,SACqC;AACrC,OAAI,CAAC,QAAS,QAAO;GAErB,MAAM,YAAqC,EAAE;AAC7C,QAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,CAChD,KAAI,KAAK,iBAAiB,IAAI,CAC5B,WAAU,OAAO;YACR,OAAO,UAAU,YAAY,UAAU,KAEhD,WAAU,OAAO,MAAM,QAAQ,MAAM,GACjC,UAAU,MAAM,OAAO,MACvB;OAEJ,WAAU,OAAO;AAGrB,UAAO;;;;;EAMT,AAAQ,iBAAiB,WAA4B;AACnD,UAAO,yBAAyB,MAAM,YAAY,QAAQ,KAAK,UAAU,CAAC"}

package/dist/errors/configuration.d.ts

@@ -0,0 +1,38 @@
+import { AppKitError } from "./base.js";
+
+//#region src/errors/configuration.d.ts
+
+/**
+ * Error thrown when configuration is missing or invalid.
+ * Use for missing environment variables, invalid settings, or setup issues.
+ *
+ * @example
+ * ```typescript
+ * throw new ConfigurationError("DATABRICKS_HOST environment variable is required");
+ * throw new ConfigurationError("Warehouse ID not found", { context: { env: "production" } });
+ * ```
+ */
+declare class ConfigurationError extends AppKitError {
+  readonly code = "CONFIGURATION_ERROR";
+  readonly statusCode = 500;
+  readonly isRetryable = false;
+  /**
+   * Create a configuration error for missing environment variable
+   */
+  static missingEnvVar(varName: string): ConfigurationError;
+  /**
+   * Create a configuration error for missing resource
+   */
+  static resourceNotFound(resource: string, hint?: string): ConfigurationError;
+  /**
+   * Create a configuration error for invalid connection config
+   */
+  static invalidConnection(service: string, details?: string): ConfigurationError;
+  /**
+   * Create a configuration error for missing connection string parameter
+   */
+  static missingConnectionParam(param: string): ConfigurationError;
+}
+//#endregion
+export { ConfigurationError };
+//# sourceMappingURL=configuration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","names":[],"sources":["../../src/errors/configuration.ts"],"sourcesContent":[],"mappings":";;;;;;AAYA;;;;;;;;cAAa,kBAAA,SAA2B,WAAA;;;;;;;yCAQC;;;;4DAUmB;;;;+DAavD;;;;gDAU2C"}

package/dist/errors/configuration.js

@@ -0,0 +1,45 @@
+import { __esmMin } from "../_virtual/rolldown_runtime.js";
+import { AppKitError, init_base } from "./base.js";
+
+//#region src/errors/configuration.ts
+var ConfigurationError;
+var init_configuration = __esmMin((() => {
+	init_base();
+	ConfigurationError = class ConfigurationError extends AppKitError {
+		constructor(..._args) {
+			super(..._args);
+			this.code = "CONFIGURATION_ERROR";
+			this.statusCode = 500;
+			this.isRetryable = false;
+		}
+		/**
+		* Create a configuration error for missing environment variable
+		*/
+		static missingEnvVar(varName) {
+			return new ConfigurationError(`${varName} environment variable is required`, { context: { envVar: varName } });
+		}
+		/**
+		* Create a configuration error for missing resource
+		*/
+		static resourceNotFound(resource, hint) {
+			return new ConfigurationError(hint ? `${resource} not found. ${hint}` : `${resource} not found`, { context: { resource } });
+		}
+		/**
+		* Create a configuration error for invalid connection config
+		*/
+		static invalidConnection(service, details) {
+			return new ConfigurationError(details ? `${service} connection not configured. ${details}` : `${service} connection not configured`, { context: { service } });
+		}
+		/**
+		* Create a configuration error for missing connection string parameter
+		*/
+		static missingConnectionParam(param) {
+			return new ConfigurationError(`Connection string must include ${param} parameter`, { context: { parameter: param } });
+		}
+	};
+}));
+
+//#endregion
+init_configuration();
+export { ConfigurationError, init_configuration };
+//# sourceMappingURL=configuration.js.map

package/dist/errors/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","names":[],"sources":["../../src/errors/configuration.ts"],"sourcesContent":["import { AppKitError } from \"./base\";\n\n/**\n * Error thrown when configuration is missing or invalid.\n * Use for missing environment variables, invalid settings, or setup issues.\n *\n * @example\n * ```typescript\n * throw new ConfigurationError(\"DATABRICKS_HOST environment variable is required\");\n * throw new ConfigurationError(\"Warehouse ID not found\", { context: { env: \"production\" } });\n * ```\n */\nexport class ConfigurationError extends AppKitError {\n  readonly code = \"CONFIGURATION_ERROR\";\n  readonly statusCode = 500;\n  readonly isRetryable = false;\n\n  /**\n   * Create a configuration error for missing environment variable\n   */\n  static missingEnvVar(varName: string): ConfigurationError {\n    return new ConfigurationError(\n      `${varName} environment variable is required`,\n      { context: { envVar: varName } },\n    );\n  }\n\n  /**\n   * Create a configuration error for missing resource\n   */\n  static resourceNotFound(resource: string, hint?: string): ConfigurationError {\n    const message = hint\n      ? `${resource} not found. ${hint}`\n      : `${resource} not found`;\n    return new ConfigurationError(message, { context: { resource } });\n  }\n\n  /**\n   * Create a configuration error for invalid connection config\n   */\n  static invalidConnection(\n    service: string,\n    details?: string,\n  ): ConfigurationError {\n    const message = details\n      ? `${service} connection not configured. ${details}`\n      : `${service} connection not configured`;\n    return new ConfigurationError(message, { context: { service } });\n  }\n\n  /**\n   * Create a configuration error for missing connection string parameter\n   */\n  static missingConnectionParam(param: string): ConfigurationError {\n    return new ConfigurationError(\n      `Connection string must include ${param} parameter`,\n      { context: { parameter: param } },\n    );\n  }\n}\n"],"mappings":";;;;;;YAAqC;CAYxB,qBAAb,MAAa,2BAA2B,YAAY;;;eAClC;qBACM;sBACC;;;;;EAKvB,OAAO,cAAc,SAAqC;AACxD,UAAO,IAAI,mBACT,GAAG,QAAQ,oCACX,EAAE,SAAS,EAAE,QAAQ,SAAS,EAAE,CACjC;;;;;EAMH,OAAO,iBAAiB,UAAkB,MAAmC;AAI3E,UAAO,IAAI,mBAHK,OACZ,GAAG,SAAS,cAAc,SAC1B,GAAG,SAAS,aACuB,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;;;;;EAMnE,OAAO,kBACL,SACA,SACoB;AAIpB,UAAO,IAAI,mBAHK,UACZ,GAAG,QAAQ,8BAA8B,YACzC,GAAG,QAAQ,6BACwB,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;;;;;EAMlE,OAAO,uBAAuB,OAAmC;AAC/D,UAAO,IAAI,mBACT,kCAAkC,MAAM,aACxC,EAAE,SAAS,EAAE,WAAW,OAAO,EAAE,CAClC"}

package/dist/errors/connection.d.ts

@@ -0,0 +1,42 @@
+import { AppKitError } from "./base.js";
+
+//#region src/errors/connection.d.ts
+
+/**
+ * Error thrown when a connection or network operation fails.
+ * Use for database pool errors, API failures, timeouts, etc.
+ *
+ * @example
+ * ```typescript
+ * throw new ConnectionError("Query failed", { cause: pgError });
+ * throw new ConnectionError("No response received from SQL Warehouse API");
+ * ```
+ */
+declare class ConnectionError extends AppKitError {
+  readonly code = "CONNECTION_ERROR";
+  readonly statusCode = 503;
+  readonly isRetryable = true;
+  /**
+   * Create a connection error for query failure
+   */
+  static queryFailed(cause?: Error): ConnectionError;
+  /**
+   * Create a connection error for transaction failure
+   */
+  static transactionFailed(cause?: Error): ConnectionError;
+  /**
+   * Create a connection error for pool errors
+   */
+  static poolError(operation: string, cause?: Error): ConnectionError;
+  /**
+   * Create a connection error for API failures
+   */
+  static apiFailure(service: string, cause?: Error): ConnectionError;
+  /**
+   * Create a connection error for client unavailable
+   */
+  static clientUnavailable(clientType: string, hint?: string): ConnectionError;
+}
+//#endregion
+export { ConnectionError };
+//# sourceMappingURL=connection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","names":[],"sources":["../../src/errors/connection.ts"],"sourcesContent":[],"mappings":";;;;;;AAYA;;;;;;;;AA+B6C,cA/BhC,eAAA,SAAwB,WAAA,CA+BQ;WAAQ,IAAA,GAAA,kBAAA;WAUU,UAAA,GAAA,GAAA;WAzC1B,WAAA,GAAA,IAAA;EAAW;;;6BAQnB,QAAQ;;;;mCAOF,QAAQ;;;;8CAOG,QAAQ;;;;6CAST,QAAQ;;;;+DAUU"}

package/dist/errors/connection.js

@@ -0,0 +1,54 @@
+import { __esmMin } from "../_virtual/rolldown_runtime.js";
+import { AppKitError, init_base } from "./base.js";
+
+//#region src/errors/connection.ts
+var ConnectionError;
+var init_connection = __esmMin((() => {
+	init_base();
+	ConnectionError = class ConnectionError extends AppKitError {
+		constructor(..._args) {
+			super(..._args);
+			this.code = "CONNECTION_ERROR";
+			this.statusCode = 503;
+			this.isRetryable = true;
+		}
+		/**
+		* Create a connection error for query failure
+		*/
+		static queryFailed(cause) {
+			return new ConnectionError("Query failed", { cause });
+		}
+		/**
+		* Create a connection error for transaction failure
+		*/
+		static transactionFailed(cause) {
+			return new ConnectionError("Transaction failed", { cause });
+		}
+		/**
+		* Create a connection error for pool errors
+		*/
+		static poolError(operation, cause) {
+			return new ConnectionError(`Connection pool error: ${operation}`, { cause });
+		}
+		/**
+		* Create a connection error for API failures
+		*/
+		static apiFailure(service, cause) {
+			return new ConnectionError(`No response received from ${service} API`, {
+				cause,
+				context: { service }
+			});
+		}
+		/**
+		* Create a connection error for client unavailable
+		*/
+		static clientUnavailable(clientType, hint) {
+			return new ConnectionError(hint ? `${clientType} not available. ${hint}` : `${clientType} not available`, { context: { clientType } });
+		}
+	};
+}));
+
+//#endregion
+init_connection();
+export { ConnectionError, init_connection };
+//# sourceMappingURL=connection.js.map

package/dist/errors/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","names":[],"sources":["../../src/errors/connection.ts"],"sourcesContent":["import { AppKitError } from \"./base\";\n\n/**\n * Error thrown when a connection or network operation fails.\n * Use for database pool errors, API failures, timeouts, etc.\n *\n * @example\n * ```typescript\n * throw new ConnectionError(\"Query failed\", { cause: pgError });\n * throw new ConnectionError(\"No response received from SQL Warehouse API\");\n * ```\n */\nexport class ConnectionError extends AppKitError {\n  readonly code = \"CONNECTION_ERROR\";\n  readonly statusCode = 503;\n  readonly isRetryable = true;\n\n  /**\n   * Create a connection error for query failure\n   */\n  static queryFailed(cause?: Error): ConnectionError {\n    return new ConnectionError(\"Query failed\", { cause });\n  }\n\n  /**\n   * Create a connection error for transaction failure\n   */\n  static transactionFailed(cause?: Error): ConnectionError {\n    return new ConnectionError(\"Transaction failed\", { cause });\n  }\n\n  /**\n   * Create a connection error for pool errors\n   */\n  static poolError(operation: string, cause?: Error): ConnectionError {\n    return new ConnectionError(`Connection pool error: ${operation}`, {\n      cause,\n    });\n  }\n\n  /**\n   * Create a connection error for API failures\n   */\n  static apiFailure(service: string, cause?: Error): ConnectionError {\n    return new ConnectionError(`No response received from ${service} API`, {\n      cause,\n      context: { service },\n    });\n  }\n\n  /**\n   * Create a connection error for client unavailable\n   */\n  static clientUnavailable(clientType: string, hint?: string): ConnectionError {\n    const message = hint\n      ? `${clientType} not available. ${hint}`\n      : `${clientType} not available`;\n    return new ConnectionError(message, { context: { clientType } });\n  }\n}\n"],"mappings":";;;;;;YAAqC;CAYxB,kBAAb,MAAa,wBAAwB,YAAY;;;eAC/B;qBACM;sBACC;;;;;EAKvB,OAAO,YAAY,OAAgC;AACjD,UAAO,IAAI,gBAAgB,gBAAgB,EAAE,OAAO,CAAC;;;;;EAMvD,OAAO,kBAAkB,OAAgC;AACvD,UAAO,IAAI,gBAAgB,sBAAsB,EAAE,OAAO,CAAC;;;;;EAM7D,OAAO,UAAU,WAAmB,OAAgC;AAClE,UAAO,IAAI,gBAAgB,0BAA0B,aAAa,EAChE,OACD,CAAC;;;;;EAMJ,OAAO,WAAW,SAAiB,OAAgC;AACjE,UAAO,IAAI,gBAAgB,6BAA6B,QAAQ,OAAO;IACrE;IACA,SAAS,EAAE,SAAS;IACrB,CAAC;;;;;EAMJ,OAAO,kBAAkB,YAAoB,MAAgC;AAI3E,UAAO,IAAI,gBAHK,OACZ,GAAG,WAAW,kBAAkB,SAChC,GAAG,WAAW,iBACkB,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC"}

package/dist/errors/execution.d.ts

@@ -0,0 +1,42 @@
+import { AppKitError } from "./base.js";
+
+//#region src/errors/execution.d.ts
+
+/**
+ * Error thrown when an operation execution fails.
+ * Use for statement failures, canceled operations, or unexpected states.
+ *
+ * @example
+ * ```typescript
+ * throw new ExecutionError("Statement failed: syntax error");
+ * throw new ExecutionError("Statement was canceled");
+ * ```
+ */
+declare class ExecutionError extends AppKitError {
+  readonly code = "EXECUTION_ERROR";
+  readonly statusCode = 500;
+  readonly isRetryable = false;
+  /**
+   * Create an execution error for statement failure
+   */
+  static statementFailed(errorMessage?: string): ExecutionError;
+  /**
+   * Create an execution error for canceled operation
+   */
+  static canceled(): ExecutionError;
+  /**
+   * Create an execution error for closed/expired results
+   */
+  static resultsClosed(): ExecutionError;
+  /**
+   * Create an execution error for unknown state
+   */
+  static unknownState(state: string): ExecutionError;
+  /**
+   * Create an execution error for missing data
+   */
+  static missingData(dataType: string): ExecutionError;
+}
+//#endregion
+export { ExecutionError };
+//# sourceMappingURL=execution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","names":[],"sources":["../../src/errors/execution.ts"],"sourcesContent":[],"mappings":";;;;;;AAYA;;;;;;;;AAA+C,cAAlC,cAAA,SAAuB,WAAA,CAAW;;;;;;;iDAQE;;;;qBAU5B;;;;0BAOK;;;;sCASY;;;;wCASE"}

package/dist/errors/execution.js

@@ -0,0 +1,51 @@
+import { __esmMin } from "../_virtual/rolldown_runtime.js";
+import { AppKitError, init_base } from "./base.js";
+
+//#region src/errors/execution.ts
+var ExecutionError;
+var init_execution = __esmMin((() => {
+	init_base();
+	ExecutionError = class ExecutionError extends AppKitError {
+		constructor(..._args) {
+			super(..._args);
+			this.code = "EXECUTION_ERROR";
+			this.statusCode = 500;
+			this.isRetryable = false;
+		}
+		/**
+		* Create an execution error for statement failure
+		*/
+		static statementFailed(errorMessage) {
+			return new ExecutionError(errorMessage ? `Statement failed: ${errorMessage}` : "Statement failed: Unknown error");
+		}
+		/**
+		* Create an execution error for canceled operation
+		*/
+		static canceled() {
+			return new ExecutionError("Statement was canceled");
+		}
+		/**
+		* Create an execution error for closed/expired results
+		*/
+		static resultsClosed() {
+			return new ExecutionError("Statement execution completed but results are no longer available (CLOSED state)");
+		}
+		/**
+		* Create an execution error for unknown state
+		*/
+		static unknownState(state) {
+			return new ExecutionError(`Unknown statement state: ${state}`, { context: { state } });
+		}
+		/**
+		* Create an execution error for missing data
+		*/
+		static missingData(dataType) {
+			return new ExecutionError(`No ${dataType} found in response`, { context: { dataType } });
+		}
+	};
+}));
+
+//#endregion
+init_execution();
+export { ExecutionError, init_execution };
+//# sourceMappingURL=execution.js.map

package/dist/errors/execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","names":[],"sources":["../../src/errors/execution.ts"],"sourcesContent":["import { AppKitError } from \"./base\";\n\n/**\n * Error thrown when an operation execution fails.\n * Use for statement failures, canceled operations, or unexpected states.\n *\n * @example\n * ```typescript\n * throw new ExecutionError(\"Statement failed: syntax error\");\n * throw new ExecutionError(\"Statement was canceled\");\n * ```\n */\nexport class ExecutionError extends AppKitError {\n  readonly code = \"EXECUTION_ERROR\";\n  readonly statusCode = 500;\n  readonly isRetryable = false;\n\n  /**\n   * Create an execution error for statement failure\n   */\n  static statementFailed(errorMessage?: string): ExecutionError {\n    const message = errorMessage\n      ? `Statement failed: ${errorMessage}`\n      : \"Statement failed: Unknown error\";\n    return new ExecutionError(message);\n  }\n\n  /**\n   * Create an execution error for canceled operation\n   */\n  static canceled(): ExecutionError {\n    return new ExecutionError(\"Statement was canceled\");\n  }\n\n  /**\n   * Create an execution error for closed/expired results\n   */\n  static resultsClosed(): ExecutionError {\n    return new ExecutionError(\n      \"Statement execution completed but results are no longer available (CLOSED state)\",\n    );\n  }\n\n  /**\n   * Create an execution error for unknown state\n   */\n  static unknownState(state: string): ExecutionError {\n    return new ExecutionError(`Unknown statement state: ${state}`, {\n      context: { state },\n    });\n  }\n\n  /**\n   * Create an execution error for missing data\n   */\n  static missingData(dataType: string): ExecutionError {\n    return new ExecutionError(`No ${dataType} found in response`, {\n      context: { dataType },\n    });\n  }\n}\n"],"mappings":";;;;;;YAAqC;CAYxB,iBAAb,MAAa,uBAAuB,YAAY;;;eAC9B;qBACM;sBACC;;;;;EAKvB,OAAO,gBAAgB,cAAuC;AAI5D,UAAO,IAAI,eAHK,eACZ,qBAAqB,iBACrB,kCAC8B;;;;;EAMpC,OAAO,WAA2B;AAChC,UAAO,IAAI,eAAe,yBAAyB;;;;;EAMrD,OAAO,gBAAgC;AACrC,UAAO,IAAI,eACT,mFACD;;;;;EAMH,OAAO,aAAa,OAA+B;AACjD,UAAO,IAAI,eAAe,4BAA4B,SAAS,EAC7D,SAAS,EAAE,OAAO,EACnB,CAAC;;;;;EAMJ,OAAO,YAAY,UAAkC;AACnD,UAAO,IAAI,eAAe,MAAM,SAAS,qBAAqB,EAC5D,SAAS,EAAE,UAAU,EACtB,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,28 @@
+import { __esmMin } from "../_virtual/rolldown_runtime.js";
+import { AppKitError, init_base } from "./base.js";
+import { AuthenticationError, init_authentication } from "./authentication.js";
+import { ConfigurationError, init_configuration } from "./configuration.js";
+import { ConnectionError, init_connection } from "./connection.js";
+import { ExecutionError, init_execution } from "./execution.js";
+import { InitializationError, init_initialization } from "./initialization.js";
+import { ServerError, init_server } from "./server.js";
+import { TunnelError, init_tunnel } from "./tunnel.js";
+import { ValidationError, init_validation } from "./validation.js";
+
+//#region src/errors/index.ts
+var init_errors = __esmMin((() => {
+	init_authentication();
+	init_base();
+	init_configuration();
+	init_connection();
+	init_execution();
+	init_initialization();
+	init_server();
+	init_tunnel();
+	init_validation();
+}));
+
+//#endregion
+init_errors();
+export { init_errors };
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/errors/index.ts"],"sourcesContent":["/**\n * AppKit Error Classes\n *\n * Standardized error classes for consistent error handling across the framework.\n *\n * @example\n * ```typescript\n * import { ValidationError, AuthenticationError } from \"@databricks/appkit\";\n *\n * // Validation errors\n * throw new ValidationError(\"Invalid parameter value\");\n * throw ValidationError.missingField(\"warehouseId\");\n *\n * // Authentication errors\n * throw AuthenticationError.missingToken();\n *\n * // Configuration errors\n * throw ConfigurationError.missingEnvVar(\"DATABRICKS_HOST\");\n * ```\n */\n\nexport { AuthenticationError } from \"./authentication\";\nexport { AppKitError } from \"./base\";\nexport { ConfigurationError } from \"./configuration\";\nexport { ConnectionError } from \"./connection\";\nexport { ExecutionError } from \"./execution\";\nexport { InitializationError } from \"./initialization\";\nexport { ServerError } from \"./server\";\nexport { TunnelError } from \"./tunnel\";\nexport { ValidationError } from \"./validation\";\n"],"mappings":";;;;;;;;;;;;;sBAqBuD;YAClB;qBACgB;kBACN;iBACF;sBACU;cAChB;cACA;kBACQ"}

package/dist/errors/initialization.d.ts

@@ -0,0 +1,34 @@
+import { AppKitError } from "./base.js";
+
+//#region src/errors/initialization.d.ts
+
+/**
+ * Error thrown when a service or component is not properly initialized.
+ * Use when accessing services before they are ready.
+ *
+ * @example
+ * ```typescript
+ * throw new InitializationError("CacheManager not initialized");
+ * throw new InitializationError("ServiceContext not initialized. Call ServiceContext.initialize() first.");
+ * ```
+ */
+declare class InitializationError extends AppKitError {
+  readonly code = "INITIALIZATION_ERROR";
+  readonly statusCode = 500;
+  readonly isRetryable = true;
+  /**
+   * Create an initialization error for a service that is not ready
+   */
+  static notInitialized(serviceName: string, hint?: string): InitializationError;
+  /**
+   * Create an initialization error for setup failure
+   */
+  static setupFailed(component: string, cause?: Error): InitializationError;
+  /**
+   * Create an initialization error for migration failure
+   */
+  static migrationFailed(cause?: Error): InitializationError;
+}
+//#endregion
+export { InitializationError };
+//# sourceMappingURL=initialization.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"initialization.d.ts","names":[],"sources":["../../src/errors/initialization.ts"],"sourcesContent":[],"mappings":";;;;;;AAYA;;;;;;;;AAAoD,cAAvC,mBAAA,SAA4B,WAAA,CAAW;;;;;;;6DAW/C;;;;gDAY2C,QAAQ;;;;iCAUvB,QAAQ"}

package/dist/errors/initialization.js

@@ -0,0 +1,42 @@
+import { __esmMin } from "../_virtual/rolldown_runtime.js";
+import { AppKitError, init_base } from "./base.js";
+
+//#region src/errors/initialization.ts
+var InitializationError;
+var init_initialization = __esmMin((() => {
+	init_base();
+	InitializationError = class InitializationError extends AppKitError {
+		constructor(..._args) {
+			super(..._args);
+			this.code = "INITIALIZATION_ERROR";
+			this.statusCode = 500;
+			this.isRetryable = true;
+		}
+		/**
+		* Create an initialization error for a service that is not ready
+		*/
+		static notInitialized(serviceName, hint) {
+			return new InitializationError(hint ? `${serviceName} not initialized. ${hint}` : `${serviceName} not initialized`, { context: { service: serviceName } });
+		}
+		/**
+		* Create an initialization error for setup failure
+		*/
+		static setupFailed(component, cause) {
+			return new InitializationError(`Failed to initialize ${component}`, {
+				cause,
+				context: { component }
+			});
+		}
+		/**
+		* Create an initialization error for migration failure
+		*/
+		static migrationFailed(cause) {
+			return new InitializationError("Error in running migrations for persistent storage", { cause });
+		}
+	};
+}));
+
+//#endregion
+init_initialization();
+export { InitializationError, init_initialization };
+//# sourceMappingURL=initialization.js.map

package/dist/errors/initialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialization.js","names":[],"sources":["../../src/errors/initialization.ts"],"sourcesContent":["import { AppKitError } from \"./base\";\n\n/**\n * Error thrown when a service or component is not properly initialized.\n * Use when accessing services before they are ready.\n *\n * @example\n * ```typescript\n * throw new InitializationError(\"CacheManager not initialized\");\n * throw new InitializationError(\"ServiceContext not initialized. Call ServiceContext.initialize() first.\");\n * ```\n */\nexport class InitializationError extends AppKitError {\n  readonly code = \"INITIALIZATION_ERROR\";\n  readonly statusCode = 500;\n  readonly isRetryable = true;\n\n  /**\n   * Create an initialization error for a service that is not ready\n   */\n  static notInitialized(\n    serviceName: string,\n    hint?: string,\n  ): InitializationError {\n    const message = hint\n      ? `${serviceName} not initialized. ${hint}`\n      : `${serviceName} not initialized`;\n    return new InitializationError(message, {\n      context: { service: serviceName },\n    });\n  }\n\n  /**\n   * Create an initialization error for setup failure\n   */\n  static setupFailed(component: string, cause?: Error): InitializationError {\n    return new InitializationError(`Failed to initialize ${component}`, {\n      cause,\n      context: { component },\n    });\n  }\n\n  /**\n   * Create an initialization error for migration failure\n   */\n  static migrationFailed(cause?: Error): InitializationError {\n    return new InitializationError(\n      \"Error in running migrations for persistent storage\",\n      { cause },\n    );\n  }\n}\n"],"mappings":";;;;;;YAAqC;CAYxB,sBAAb,MAAa,4BAA4B,YAAY;;;eACnC;qBACM;sBACC;;;;;EAKvB,OAAO,eACL,aACA,MACqB;AAIrB,UAAO,IAAI,oBAHK,OACZ,GAAG,YAAY,oBAAoB,SACnC,GAAG,YAAY,mBACqB,EACtC,SAAS,EAAE,SAAS,aAAa,EAClC,CAAC;;;;;EAMJ,OAAO,YAAY,WAAmB,OAAoC;AACxE,UAAO,IAAI,oBAAoB,wBAAwB,aAAa;IAClE;IACA,SAAS,EAAE,WAAW;IACvB,CAAC;;;;;EAMJ,OAAO,gBAAgB,OAAoC;AACzD,UAAO,IAAI,oBACT,sDACA,EAAE,OAAO,CACV"}

package/dist/errors/server.d.ts

@@ -0,0 +1,38 @@
+import { AppKitError } from "./base.js";
+
+//#region src/errors/server.d.ts
+
+/**
+ * Error thrown when server lifecycle operations fail.
+ * Use for server start/stop issues, configuration conflicts, etc.
+ *
+ * @example
+ * ```typescript
+ * throw new ServerError("Cannot get server when autoStart is true");
+ * throw new ServerError("Server not started");
+ * ```
+ */
+declare class ServerError extends AppKitError {
+  readonly code = "SERVER_ERROR";
+  readonly statusCode = 500;
+  readonly isRetryable = false;
+  /**
+   * Create a server error for autoStart conflict
+   */
+  static autoStartConflict(operation: string): ServerError;
+  /**
+   * Create a server error for server not started
+   */
+  static notStarted(): ServerError;
+  /**
+   * Create a server error for Vite dev server not initialized
+   */
+  static viteNotInitialized(): ServerError;
+  /**
+   * Create a server error for missing client directory
+   */
+  static clientDirectoryNotFound(searchedPaths: string[]): ServerError;
+}
+//#endregion
+export { ServerError };
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","names":[],"sources":["../../src/errors/server.ts"],"sourcesContent":[],"mappings":";;;;;;AAYA;;;;;;;;cAAa,WAAA,SAAoB,WAAA;;;;;;;+CAQc;;;;uBASxB;;;;+BASQ;;;;2DAO4B"}