@databricks/appkit 0.4.1 → 0.5.1

package/dist/errors/configuration.js

@@ -6,12 +6,9 @@ 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;
-		}
+		code = "CONFIGURATION_ERROR";
+		statusCode = 500;
+		isRetryable = false;
 		/**
 		* Create a configuration error for missing environment variable
 		*/

package/dist/errors/configuration.js.map

@@ -1 +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"}
+{"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;EAClD,AAAS,OAAO;EAChB,AAAS,aAAa;EACtB,AAAS,cAAc;;;;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.js

@@ -6,12 +6,9 @@ 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;
-		}
+		code = "CONNECTION_ERROR";
+		statusCode = 503;
+		isRetryable = true;
 		/**
 		* Create a connection error for query failure
 		*/

package/dist/errors/connection.js.map

@@ -1 +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"}
+{"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/C,AAAS,OAAO;EAChB,AAAS,aAAa;EACtB,AAAS,cAAc;;;;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.js

@@ -6,12 +6,9 @@ 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;
-		}
+		code = "EXECUTION_ERROR";
+		statusCode = 500;
+		isRetryable = false;
 		/**
 		* Create an execution error for statement failure
 		*/

package/dist/errors/execution.js.map

@@ -1 +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"}
+{"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;EAC9C,AAAS,OAAO;EAChB,AAAS,aAAa;EACtB,AAAS,cAAc;;;;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/initialization.js

@@ -6,12 +6,9 @@ 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;
-		}
+		code = "INITIALIZATION_ERROR";
+		statusCode = 500;
+		isRetryable = true;
 		/**
 		* Create an initialization error for a service that is not ready
 		*/

package/dist/errors/initialization.js.map

@@ -1 +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"}
+{"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;EACnD,AAAS,OAAO;EAChB,AAAS,aAAa;EACtB,AAAS,cAAc;;;;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.js

@@ -6,12 +6,9 @@ var ServerError;
 var init_server = __esmMin((() => {
 	init_base();
 	ServerError = class ServerError extends AppKitError {
-		constructor(..._args) {
-			super(..._args);
-			this.code = "SERVER_ERROR";
-			this.statusCode = 500;
-			this.isRetryable = false;
-		}
+		code = "SERVER_ERROR";
+		statusCode = 500;
+		isRetryable = false;
 		/**
 		* Create a server error for autoStart conflict
 		*/

package/dist/errors/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","names":[],"sources":["../../src/errors/server.ts"],"sourcesContent":["import { AppKitError } from \"./base\";\n\n/**\n * Error thrown when server lifecycle operations fail.\n * Use for server start/stop issues, configuration conflicts, etc.\n *\n * @example\n * ```typescript\n * throw new ServerError(\"Cannot get server when autoStart is true\");\n * throw new ServerError(\"Server not started\");\n * ```\n */\nexport class ServerError extends AppKitError {\n  readonly code = \"SERVER_ERROR\";\n  readonly statusCode = 500;\n  readonly isRetryable = false;\n\n  /**\n   * Create a server error for autoStart conflict\n   */\n  static autoStartConflict(operation: string): ServerError {\n    return new ServerError(`Cannot ${operation} when autoStart is true`, {\n      context: { operation },\n    });\n  }\n\n  /**\n   * Create a server error for server not started\n   */\n  static notStarted(): ServerError {\n    return new ServerError(\n      \"Server not started. Please start the server first by calling the start() method\",\n    );\n  }\n\n  /**\n   * Create a server error for Vite dev server not initialized\n   */\n  static viteNotInitialized(): ServerError {\n    return new ServerError(\"Vite dev server not initialized\");\n  }\n\n  /**\n   * Create a server error for missing client directory\n   */\n  static clientDirectoryNotFound(searchedPaths: string[]): ServerError {\n    return new ServerError(\n      `Could not find client directory. Searched for vite.config.ts/js + index.html in: ${searchedPaths.join(\", \")}`,\n      { context: { searchedPaths } },\n    );\n  }\n}\n"],"mappings":";;;;;;YAAqC;CAYxB,cAAb,MAAa,oBAAoB,YAAY;;;eAC3B;qBACM;sBACC;;;;;EAKvB,OAAO,kBAAkB,WAAgC;AACvD,UAAO,IAAI,YAAY,UAAU,UAAU,0BAA0B,EACnE,SAAS,EAAE,WAAW,EACvB,CAAC;;;;;EAMJ,OAAO,aAA0B;AAC/B,UAAO,IAAI,YACT,kFACD;;;;;EAMH,OAAO,qBAAkC;AACvC,UAAO,IAAI,YAAY,kCAAkC;;;;;EAM3D,OAAO,wBAAwB,eAAsC;AACnE,UAAO,IAAI,YACT,oFAAoF,cAAc,KAAK,KAAK,IAC5G,EAAE,SAAS,EAAE,eAAe,EAAE,CAC/B"}
+{"version":3,"file":"server.js","names":[],"sources":["../../src/errors/server.ts"],"sourcesContent":["import { AppKitError } from \"./base\";\n\n/**\n * Error thrown when server lifecycle operations fail.\n * Use for server start/stop issues, configuration conflicts, etc.\n *\n * @example\n * ```typescript\n * throw new ServerError(\"Cannot get server when autoStart is true\");\n * throw new ServerError(\"Server not started\");\n * ```\n */\nexport class ServerError extends AppKitError {\n  readonly code = \"SERVER_ERROR\";\n  readonly statusCode = 500;\n  readonly isRetryable = false;\n\n  /**\n   * Create a server error for autoStart conflict\n   */\n  static autoStartConflict(operation: string): ServerError {\n    return new ServerError(`Cannot ${operation} when autoStart is true`, {\n      context: { operation },\n    });\n  }\n\n  /**\n   * Create a server error for server not started\n   */\n  static notStarted(): ServerError {\n    return new ServerError(\n      \"Server not started. Please start the server first by calling the start() method\",\n    );\n  }\n\n  /**\n   * Create a server error for Vite dev server not initialized\n   */\n  static viteNotInitialized(): ServerError {\n    return new ServerError(\"Vite dev server not initialized\");\n  }\n\n  /**\n   * Create a server error for missing client directory\n   */\n  static clientDirectoryNotFound(searchedPaths: string[]): ServerError {\n    return new ServerError(\n      `Could not find client directory. Searched for vite.config.ts/js + index.html in: ${searchedPaths.join(\", \")}`,\n      { context: { searchedPaths } },\n    );\n  }\n}\n"],"mappings":";;;;;;YAAqC;CAYxB,cAAb,MAAa,oBAAoB,YAAY;EAC3C,AAAS,OAAO;EAChB,AAAS,aAAa;EACtB,AAAS,cAAc;;;;EAKvB,OAAO,kBAAkB,WAAgC;AACvD,UAAO,IAAI,YAAY,UAAU,UAAU,0BAA0B,EACnE,SAAS,EAAE,WAAW,EACvB,CAAC;;;;;EAMJ,OAAO,aAA0B;AAC/B,UAAO,IAAI,YACT,kFACD;;;;;EAMH,OAAO,qBAAkC;AACvC,UAAO,IAAI,YAAY,kCAAkC;;;;;EAM3D,OAAO,wBAAwB,eAAsC;AACnE,UAAO,IAAI,YACT,oFAAoF,cAAc,KAAK,KAAK,IAC5G,EAAE,SAAS,EAAE,eAAe,EAAE,CAC/B"}

package/dist/errors/tunnel.js

@@ -6,12 +6,9 @@ var TunnelError;
 var init_tunnel = __esmMin((() => {
 	init_base();
 	TunnelError = class TunnelError extends AppKitError {
-		constructor(..._args) {
-			super(..._args);
-			this.code = "TUNNEL_ERROR";
-			this.statusCode = 502;
-			this.isRetryable = true;
-		}
+		code = "TUNNEL_ERROR";
+		statusCode = 502;
+		isRetryable = true;
 		/**
 		* Create a tunnel error for missing tunnel getter
 		*/

package/dist/errors/tunnel.js.map

@@ -1 +1 @@
-{"version":3,"file":"tunnel.js","names":[],"sources":["../../src/errors/tunnel.ts"],"sourcesContent":["import { AppKitError } from \"./base\";\n\n/**\n * Error thrown when remote tunnel operations fail.\n * Use for tunnel connection issues, message parsing failures, etc.\n *\n * @example\n * ```typescript\n * throw new TunnelError(\"No tunnel connection available\");\n * throw new TunnelError(\"Failed to parse WebSocket message\", { cause: parseError });\n * ```\n */\nexport class TunnelError extends AppKitError {\n  readonly code = \"TUNNEL_ERROR\";\n  readonly statusCode = 502;\n  readonly isRetryable = true;\n\n  /**\n   * Create a tunnel error for missing tunnel getter\n   */\n  static getterNotRegistered(): TunnelError {\n    return new TunnelError(\n      \"Tunnel getter not registered for DevFileReader singleton\",\n    );\n  }\n\n  /**\n   * Create a tunnel error for no available connection\n   */\n  static noConnection(): TunnelError {\n    return new TunnelError(\"No tunnel connection available for file read\");\n  }\n\n  /**\n   * Create a tunnel error for asset fetch failure\n   */\n  static fetchFailed(path: string, cause?: Error): TunnelError {\n    return new TunnelError(\"Failed to fetch asset\", {\n      cause,\n      context: { path },\n    });\n  }\n\n  /**\n   * Create a tunnel error for message parsing failure\n   */\n  static parseError(messageType: string, cause?: Error): TunnelError {\n    return new TunnelError(`Failed to parse ${messageType} message`, {\n      cause,\n      context: { messageType },\n    });\n  }\n}\n"],"mappings":";;;;;;YAAqC;CAYxB,cAAb,MAAa,oBAAoB,YAAY;;;eAC3B;qBACM;sBACC;;;;;EAKvB,OAAO,sBAAmC;AACxC,UAAO,IAAI,YACT,2DACD;;;;;EAMH,OAAO,eAA4B;AACjC,UAAO,IAAI,YAAY,+CAA+C;;;;;EAMxE,OAAO,YAAY,MAAc,OAA4B;AAC3D,UAAO,IAAI,YAAY,yBAAyB;IAC9C;IACA,SAAS,EAAE,MAAM;IAClB,CAAC;;;;;EAMJ,OAAO,WAAW,aAAqB,OAA4B;AACjE,UAAO,IAAI,YAAY,mBAAmB,YAAY,WAAW;IAC/D;IACA,SAAS,EAAE,aAAa;IACzB,CAAC"}
+{"version":3,"file":"tunnel.js","names":[],"sources":["../../src/errors/tunnel.ts"],"sourcesContent":["import { AppKitError } from \"./base\";\n\n/**\n * Error thrown when remote tunnel operations fail.\n * Use for tunnel connection issues, message parsing failures, etc.\n *\n * @example\n * ```typescript\n * throw new TunnelError(\"No tunnel connection available\");\n * throw new TunnelError(\"Failed to parse WebSocket message\", { cause: parseError });\n * ```\n */\nexport class TunnelError extends AppKitError {\n  readonly code = \"TUNNEL_ERROR\";\n  readonly statusCode = 502;\n  readonly isRetryable = true;\n\n  /**\n   * Create a tunnel error for missing tunnel getter\n   */\n  static getterNotRegistered(): TunnelError {\n    return new TunnelError(\n      \"Tunnel getter not registered for DevFileReader singleton\",\n    );\n  }\n\n  /**\n   * Create a tunnel error for no available connection\n   */\n  static noConnection(): TunnelError {\n    return new TunnelError(\"No tunnel connection available for file read\");\n  }\n\n  /**\n   * Create a tunnel error for asset fetch failure\n   */\n  static fetchFailed(path: string, cause?: Error): TunnelError {\n    return new TunnelError(\"Failed to fetch asset\", {\n      cause,\n      context: { path },\n    });\n  }\n\n  /**\n   * Create a tunnel error for message parsing failure\n   */\n  static parseError(messageType: string, cause?: Error): TunnelError {\n    return new TunnelError(`Failed to parse ${messageType} message`, {\n      cause,\n      context: { messageType },\n    });\n  }\n}\n"],"mappings":";;;;;;YAAqC;CAYxB,cAAb,MAAa,oBAAoB,YAAY;EAC3C,AAAS,OAAO;EAChB,AAAS,aAAa;EACtB,AAAS,cAAc;;;;EAKvB,OAAO,sBAAmC;AACxC,UAAO,IAAI,YACT,2DACD;;;;;EAMH,OAAO,eAA4B;AACjC,UAAO,IAAI,YAAY,+CAA+C;;;;;EAMxE,OAAO,YAAY,MAAc,OAA4B;AAC3D,UAAO,IAAI,YAAY,yBAAyB;IAC9C;IACA,SAAS,EAAE,MAAM;IAClB,CAAC;;;;;EAMJ,OAAO,WAAW,aAAqB,OAA4B;AACjE,UAAO,IAAI,YAAY,mBAAmB,YAAY,WAAW;IAC/D;IACA,SAAS,EAAE,aAAa;IACzB,CAAC"}

package/dist/errors/validation.js

@@ -6,12 +6,9 @@ var ValidationError;
 var init_validation = __esmMin((() => {
 	init_base();
 	ValidationError = class ValidationError extends AppKitError {
-		constructor(..._args) {
-			super(..._args);
-			this.code = "VALIDATION_ERROR";
-			this.statusCode = 400;
-			this.isRetryable = false;
-		}
+		code = "VALIDATION_ERROR";
+		statusCode = 400;
+		isRetryable = false;
 		/**
 		* Create a validation error for a missing required field
 		*/

package/dist/errors/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","names":[],"sources":["../../src/errors/validation.ts"],"sourcesContent":["import { AppKitError } from \"./base\";\n\n/**\n * Error thrown when input validation fails.\n * Use for invalid parameters, missing required fields, or type mismatches.\n *\n * @example\n * ```typescript\n * throw new ValidationError(\"Statement is required\", { context: { field: \"statement\" } });\n * throw new ValidationError(\"maxPoolSize must be at least 1\", { context: { value: config.maxPoolSize } });\n * ```\n */\nexport class ValidationError extends AppKitError {\n  readonly code = \"VALIDATION_ERROR\";\n  readonly statusCode = 400;\n  readonly isRetryable = false;\n\n  /**\n   * Create a validation error for a missing required field\n   */\n  static missingField(fieldName: string): ValidationError {\n    return new ValidationError(`Missing required field: ${fieldName}`, {\n      context: { field: fieldName },\n    });\n  }\n\n  /**\n   * Create a validation error for an invalid field value.\n   * Note: The actual value is not stored in context for security reasons.\n   * Only the value's type is recorded.\n   */\n  static invalidValue(\n    fieldName: string,\n    value: unknown,\n    expected?: string,\n  ): ValidationError {\n    const msg = expected\n      ? `Invalid value for ${fieldName}: expected ${expected}`\n      : `Invalid value for ${fieldName}`;\n    return new ValidationError(msg, {\n      context: {\n        field: fieldName,\n        valueType: value === null ? \"null\" : typeof value,\n        expected,\n      },\n    });\n  }\n\n  /**\n   * Create a validation error for missing environment variables\n   */\n  static missingEnvVars(vars: string[]): ValidationError {\n    return new ValidationError(\n      `Missing required environment variables: ${vars.join(\", \")}`,\n      { context: { missingVars: vars } },\n    );\n  }\n}\n"],"mappings":";;;;;;YAAqC;CAYxB,kBAAb,MAAa,wBAAwB,YAAY;;;eAC/B;qBACM;sBACC;;;;;EAKvB,OAAO,aAAa,WAAoC;AACtD,UAAO,IAAI,gBAAgB,2BAA2B,aAAa,EACjE,SAAS,EAAE,OAAO,WAAW,EAC9B,CAAC;;;;;;;EAQJ,OAAO,aACL,WACA,OACA,UACiB;AAIjB,UAAO,IAAI,gBAHC,WACR,qBAAqB,UAAU,aAAa,aAC5C,qBAAqB,aACO,EAC9B,SAAS;IACP,OAAO;IACP,WAAW,UAAU,OAAO,SAAS,OAAO;IAC5C;IACD,EACF,CAAC;;;;;EAMJ,OAAO,eAAe,MAAiC;AACrD,UAAO,IAAI,gBACT,2CAA2C,KAAK,KAAK,KAAK,IAC1D,EAAE,SAAS,EAAE,aAAa,MAAM,EAAE,CACnC"}
+{"version":3,"file":"validation.js","names":[],"sources":["../../src/errors/validation.ts"],"sourcesContent":["import { AppKitError } from \"./base\";\n\n/**\n * Error thrown when input validation fails.\n * Use for invalid parameters, missing required fields, or type mismatches.\n *\n * @example\n * ```typescript\n * throw new ValidationError(\"Statement is required\", { context: { field: \"statement\" } });\n * throw new ValidationError(\"maxPoolSize must be at least 1\", { context: { value: config.maxPoolSize } });\n * ```\n */\nexport class ValidationError extends AppKitError {\n  readonly code = \"VALIDATION_ERROR\";\n  readonly statusCode = 400;\n  readonly isRetryable = false;\n\n  /**\n   * Create a validation error for a missing required field\n   */\n  static missingField(fieldName: string): ValidationError {\n    return new ValidationError(`Missing required field: ${fieldName}`, {\n      context: { field: fieldName },\n    });\n  }\n\n  /**\n   * Create a validation error for an invalid field value.\n   * Note: The actual value is not stored in context for security reasons.\n   * Only the value's type is recorded.\n   */\n  static invalidValue(\n    fieldName: string,\n    value: unknown,\n    expected?: string,\n  ): ValidationError {\n    const msg = expected\n      ? `Invalid value for ${fieldName}: expected ${expected}`\n      : `Invalid value for ${fieldName}`;\n    return new ValidationError(msg, {\n      context: {\n        field: fieldName,\n        valueType: value === null ? \"null\" : typeof value,\n        expected,\n      },\n    });\n  }\n\n  /**\n   * Create a validation error for missing environment variables\n   */\n  static missingEnvVars(vars: string[]): ValidationError {\n    return new ValidationError(\n      `Missing required environment variables: ${vars.join(\", \")}`,\n      { context: { missingVars: vars } },\n    );\n  }\n}\n"],"mappings":";;;;;;YAAqC;CAYxB,kBAAb,MAAa,wBAAwB,YAAY;EAC/C,AAAS,OAAO;EAChB,AAAS,aAAa;EACtB,AAAS,cAAc;;;;EAKvB,OAAO,aAAa,WAAoC;AACtD,UAAO,IAAI,gBAAgB,2BAA2B,aAAa,EACjE,SAAS,EAAE,OAAO,WAAW,EAC9B,CAAC;;;;;;;EAQJ,OAAO,aACL,WACA,OACA,UACiB;AAIjB,UAAO,IAAI,gBAHC,WACR,qBAAqB,UAAU,aAAa,aAC5C,qBAAqB,aACO,EAC9B,SAAS;IACP,OAAO;IACP,WAAW,UAAU,OAAO,SAAS,OAAO;IAC5C;IACD,EACF,CAAC;;;;;EAMJ,OAAO,eAAe,MAAiC;AACrD,UAAO,IAAI,gBACT,2CAA2C,KAAK,KAAK,KAAK,IAC1D,EAAE,SAAS,EAAE,aAAa,MAAM,EAAE,CACnC"}

package/dist/index.d.ts

@@ -20,4 +20,5 @@ import { TunnelError } from "./errors/tunnel.js";
 import { ValidationError } from "./errors/validation.js";
 import { server } from "./server/index.js";
 import { appKitTypesPlugin } from "./type-generator/vite-plugin.js";
-export { AppKitError, AuthenticationError, type BasePluginConfig, type CacheConfig, CacheManager, ConfigurationError, ConnectionError, type Counter, ExecutionError, type Histogram, type IAppRouter, type ITelemetry, InitializationError, Plugin, ServerError, SeverityNumber, type Span, SpanStatusCode, type StreamExecutionSettings, type TelemetryConfig, TunnelError, ValidationError, analytics, appKitTypesPlugin, createApp, isSQLTypeMarker, server, sql, toPlugin };
+import { getExecutionContext } from "./context/execution-context.js";
+export { AppKitError, AuthenticationError, type BasePluginConfig, type CacheConfig, CacheManager, ConfigurationError, ConnectionError, type Counter, ExecutionError, type Histogram, type IAppRouter, type ITelemetry, InitializationError, Plugin, ServerError, SeverityNumber, type Span, SpanStatusCode, type StreamExecutionSettings, type TelemetryConfig, TunnelError, ValidationError, analytics, appKitTypesPlugin, createApp, getExecutionContext, isSQLTypeMarker, server, sql, toPlugin };

package/dist/index.js

@@ -10,6 +10,8 @@ import { ServerError } from "./errors/server.js";
 import { TunnelError } from "./errors/tunnel.js";
 import { ValidationError } from "./errors/validation.js";
 import { init_errors } from "./errors/index.js";
+import { getExecutionContext } from "./context/execution-context.js";
+import { init_context } from "./context/index.js";
 import { CacheManager } from "./cache/index.js";
 import { Plugin } from "./plugin/plugin.js";
 import { toPlugin } from "./plugin/to-plugin.js";
@@ -23,7 +25,8 @@ import { server } from "./server/index.js";
 
 //#region src/index.ts
 init_errors();
+init_context();
 
 //#endregion
-export { AppKitError, AuthenticationError, CacheManager, ConfigurationError, ConnectionError, ExecutionError, InitializationError, Plugin, ServerError, SeverityNumber, SpanStatusCode, TunnelError, ValidationError, analytics, appKitTypesPlugin, createApp, isSQLTypeMarker, server, sql, toPlugin };
+export { AppKitError, AuthenticationError, CacheManager, ConfigurationError, ConnectionError, ExecutionError, InitializationError, Plugin, ServerError, SeverityNumber, SpanStatusCode, TunnelError, ValidationError, analytics, appKitTypesPlugin, createApp, getExecutionContext, isSQLTypeMarker, server, sql, toPlugin };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @packageDocumentation\n *\n * Core library for building Databricks applications with type-safe SQL queries,\n * plugin architecture, and React integration.\n */\n\n// Types from shared\nexport type {\n  BasePluginConfig,\n  CacheConfig,\n  IAppRouter,\n  StreamExecutionSettings,\n} from \"shared\";\nexport { isSQLTypeMarker, sql } from \"shared\";\nexport { analytics } from \"./analytics\";\nexport { CacheManager } from \"./cache\";\nexport { createApp } from \"./core\";\n// Errors\nexport {\n  AppKitError,\n  AuthenticationError,\n  ConfigurationError,\n  ConnectionError,\n  ExecutionError,\n  InitializationError,\n  ServerError,\n  TunnelError,\n  ValidationError,\n} from \"./errors\";\n// Plugin authoring\nexport { Plugin, toPlugin } from \"./plugin\";\nexport { server } from \"./server\";\n// Telemetry (for advanced custom telemetry)\nexport {\n  type Counter,\n  type Histogram,\n  type ITelemetry,\n  SeverityNumber,\n  type Span,\n  SpanStatusCode,\n  type TelemetryConfig,\n} from \"./telemetry\";\n\n// Vite plugin and type generation\nexport { appKitTypesPlugin } from \"./type-generator/vite-plugin\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;aA6BkB"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @packageDocumentation\n *\n * Core library for building Databricks applications with type-safe SQL queries,\n * plugin architecture, and React integration.\n */\n\n// Types from shared\nexport type {\n  BasePluginConfig,\n  CacheConfig,\n  IAppRouter,\n  StreamExecutionSettings,\n} from \"shared\";\nexport { isSQLTypeMarker, sql } from \"shared\";\nexport { analytics } from \"./analytics\";\nexport { CacheManager } from \"./cache\";\nexport { createApp } from \"./core\";\n// Errors\nexport {\n  AppKitError,\n  AuthenticationError,\n  ConfigurationError,\n  ConnectionError,\n  ExecutionError,\n  InitializationError,\n  ServerError,\n  TunnelError,\n  ValidationError,\n} from \"./errors\";\n// Plugin authoring\nexport { Plugin, toPlugin } from \"./plugin\";\nexport { server } from \"./server\";\n// Telemetry (for advanced custom telemetry)\nexport {\n  type Counter,\n  type Histogram,\n  type ITelemetry,\n  SeverityNumber,\n  type Span,\n  SpanStatusCode,\n  type TelemetryConfig,\n} from \"./telemetry\";\n\n// Vite plugin and type generation\nexport { appKitTypesPlugin } from \"./type-generator/vite-plugin\";\nexport { getExecutionContext } from \"./context\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;aA6BkB;cAiB8B"}

package/dist/logging/wide-event-emitter.js

@@ -5,9 +5,7 @@ import { SeverityNumber, logs } from "@opentelemetry/api-logs";
 * Emits WideEvents to OpenTelemetry as structured logs
 */
 var WideEventEmitter = class {
-	constructor() {
-		this.logger = logs.getLogger("appkit", "1.0.0");
-	}
+	logger = logs.getLogger("appkit", "1.0.0");
 	/**
 	* Emit a WideEvent to OpenTelemetry.
 	* Fails silently to avoid crashing the application due to observability issues.

package/dist/logging/wide-event-emitter.js.map

@@ -1 +1 @@
-{"version":3,"file":"wide-event-emitter.js","names":[],"sources":["../../src/logging/wide-event-emitter.ts"],"sourcesContent":["import { logs, SeverityNumber } from \"@opentelemetry/api-logs\";\nimport type { WideEventData } from \"./wide-event\";\n\n/**\n * Emits WideEvents to OpenTelemetry as structured logs\n */\nexport class WideEventEmitter {\n  private logger = logs.getLogger(\"appkit\", \"1.0.0\");\n\n  /**\n   * Emit a WideEvent to OpenTelemetry.\n   * Fails silently to avoid crashing the application due to observability issues.\n   */\n  emit(event: WideEventData): void {\n    try {\n      const logRecord = {\n        timestamp: Date.parse(event.timestamp),\n        severityNumber: this.getSeverityNumber(event),\n        severityText: this.getSeverityText(event),\n        body: this.createLogBody(event),\n        attributes: this.createAttributes(event),\n      };\n\n      this.logger.emit(logRecord);\n    } catch {\n      // Silent fail - observability should never crash the application\n    }\n  }\n\n  /**\n   * Get OpenTelemetry severity number based on event data\n   */\n  private getSeverityNumber(event: WideEventData): SeverityNumber {\n    // Error level\n    if (event.error) {\n      return SeverityNumber.ERROR;\n    }\n\n    // Status code based\n    if (event.status_code) {\n      if (event.status_code >= 500) {\n        return SeverityNumber.ERROR;\n      }\n      if (event.status_code >= 400) {\n        return SeverityNumber.WARN;\n      }\n    }\n\n    // Check logs for errors/warnings\n    if (event.logs) {\n      const hasError = event.logs.some((log) => log.level === \"error\");\n      if (hasError) {\n        return SeverityNumber.ERROR;\n      }\n\n      const hasWarn = event.logs.some((log) => log.level === \"warn\");\n      if (hasWarn) {\n        return SeverityNumber.WARN;\n      }\n    }\n\n    return SeverityNumber.INFO;\n  }\n\n  /**\n   * Get severity text based on severity number\n   */\n  private getSeverityText(event: WideEventData): string {\n    const severityNumber = this.getSeverityNumber(event);\n\n    if (severityNumber >= SeverityNumber.ERROR) {\n      return \"ERROR\";\n    }\n    if (severityNumber >= SeverityNumber.WARN) {\n      return \"WARN\";\n    }\n    if (severityNumber >= SeverityNumber.INFO) {\n      return \"INFO\";\n    }\n    return \"DEBUG\";\n  }\n\n  /**\n   * Create log body from event data\n   */\n  private createLogBody(event: WideEventData): string {\n    const parts: string[] = [];\n\n    // HTTP request info\n    if (event.method && event.path) {\n      parts.push(`${event.method} ${event.path}`);\n    }\n\n    // Status code\n    if (event.status_code) {\n      parts.push(`→ ${event.status_code}`);\n    }\n\n    // Duration\n    if (event.duration_ms) {\n      parts.push(`(${event.duration_ms}ms)`);\n    }\n\n    // Component info\n    if (event.component) {\n      const componentStr = event.component.operation\n        ? `${event.component.name}.${event.component.operation}`\n        : event.component.name;\n      parts.push(`[${componentStr}]`);\n    }\n\n    // Error message\n    if (event.error) {\n      parts.push(`ERROR: ${event.error.message}`);\n    }\n\n    return parts.join(\" \");\n  }\n\n  /**\n   * Create OpenTelemetry attributes from event data\n   */\n  private createAttributes(\n    event: WideEventData,\n  ): Record<string, string | number | boolean | undefined> {\n    const attributes: Record<string, string | number | boolean | undefined> = {\n      // Request metadata\n      request_id: event.request_id,\n      trace_id: event.trace_id,\n\n      // HTTP attributes (OpenTelemetry semantic conventions)\n      \"http.method\": event.method,\n      \"http.route\": event.path,\n      \"http.status_code\": event.status_code,\n      \"http.request.duration_ms\": event.duration_ms,\n\n      // Service attributes\n      \"service.name\": event.service?.name,\n      \"service.version\": event.service?.version,\n      \"service.region\": event.service?.region,\n      \"service.deployment_id\": event.service?.deployment_id,\n      \"service.node_env\": event.service?.node_env,\n\n      // Component attributes\n      \"component.name\": event.component?.name,\n      \"component.operation\": event.component?.operation,\n\n      // User attributes\n      \"user.id\": event.user?.id,\n\n      // Error attributes\n      \"error.type\": event.error?.type,\n      \"error.code\": event.error?.code,\n      \"error.message\": event.error?.message,\n      \"error.retriable\": event.error?.retriable,\n\n      // Execution metadata\n      \"execution.timeout_ms\": event.execution?.timeout_ms,\n      \"execution.retry_attempts\": event.execution?.retry_attempts,\n      \"execution.cache_hit\": event.execution?.cache_hit,\n      \"execution.cache_key\": event.execution?.cache_key,\n      \"execution.cache_deduplication\": event.execution?.cache_deduplication,\n\n      // Stream metadata\n      \"stream.id\": event.stream?.stream_id,\n      \"stream.events_sent\": event.stream?.events_sent,\n\n      // Log count\n      log_count: event.logs?.length,\n    };\n\n    // Add custom context as attributes with scope prefix (no \"appkit\" prefix)\n    if (event.context) {\n      for (const [scope, scopeData] of Object.entries(event.context)) {\n        for (const [key, value] of Object.entries(scopeData)) {\n          // Only add primitive values\n          if (\n            typeof value === \"string\" ||\n            typeof value === \"number\" ||\n            typeof value === \"boolean\"\n          ) {\n            attributes[`${scope}.${key}`] = value;\n          }\n        }\n      }\n    }\n\n    // Remove undefined values\n    return Object.fromEntries(\n      Object.entries(attributes).filter(([_, value]) => value !== undefined),\n    );\n  }\n}\n"],"mappings":";;;;;;AAMA,IAAa,mBAAb,MAA8B;;gBACX,KAAK,UAAU,UAAU,QAAQ;;;;;;CAMlD,KAAK,OAA4B;AAC/B,MAAI;GACF,MAAM,YAAY;IAChB,WAAW,KAAK,MAAM,MAAM,UAAU;IACtC,gBAAgB,KAAK,kBAAkB,MAAM;IAC7C,cAAc,KAAK,gBAAgB,MAAM;IACzC,MAAM,KAAK,cAAc,MAAM;IAC/B,YAAY,KAAK,iBAAiB,MAAM;IACzC;AAED,QAAK,OAAO,KAAK,UAAU;UACrB;;;;;CAQV,AAAQ,kBAAkB,OAAsC;AAE9D,MAAI,MAAM,MACR,QAAO,eAAe;AAIxB,MAAI,MAAM,aAAa;AACrB,OAAI,MAAM,eAAe,IACvB,QAAO,eAAe;AAExB,OAAI,MAAM,eAAe,IACvB,QAAO,eAAe;;AAK1B,MAAI,MAAM,MAAM;AAEd,OADiB,MAAM,KAAK,MAAM,QAAQ,IAAI,UAAU,QAAQ,CAE9D,QAAO,eAAe;AAIxB,OADgB,MAAM,KAAK,MAAM,QAAQ,IAAI,UAAU,OAAO,CAE5D,QAAO,eAAe;;AAI1B,SAAO,eAAe;;;;;CAMxB,AAAQ,gBAAgB,OAA8B;EACpD,MAAM,iBAAiB,KAAK,kBAAkB,MAAM;AAEpD,MAAI,kBAAkB,eAAe,MACnC,QAAO;AAET,MAAI,kBAAkB,eAAe,KACnC,QAAO;AAET,MAAI,kBAAkB,eAAe,KACnC,QAAO;AAET,SAAO;;;;;CAMT,AAAQ,cAAc,OAA8B;EAClD,MAAM,QAAkB,EAAE;AAG1B,MAAI,MAAM,UAAU,MAAM,KACxB,OAAM,KAAK,GAAG,MAAM,OAAO,GAAG,MAAM,OAAO;AAI7C,MAAI,MAAM,YACR,OAAM,KAAK,KAAK,MAAM,cAAc;AAItC,MAAI,MAAM,YACR,OAAM,KAAK,IAAI,MAAM,YAAY,KAAK;AAIxC,MAAI,MAAM,WAAW;GACnB,MAAM,eAAe,MAAM,UAAU,YACjC,GAAG,MAAM,UAAU,KAAK,GAAG,MAAM,UAAU,cAC3C,MAAM,UAAU;AACpB,SAAM,KAAK,IAAI,aAAa,GAAG;;AAIjC,MAAI,MAAM,MACR,OAAM,KAAK,UAAU,MAAM,MAAM,UAAU;AAG7C,SAAO,MAAM,KAAK,IAAI;;;;;CAMxB,AAAQ,iBACN,OACuD;EACvD,MAAM,aAAoE;GAExE,YAAY,MAAM;GAClB,UAAU,MAAM;GAGhB,eAAe,MAAM;GACrB,cAAc,MAAM;GACpB,oBAAoB,MAAM;GAC1B,4BAA4B,MAAM;GAGlC,gBAAgB,MAAM,SAAS;GAC/B,mBAAmB,MAAM,SAAS;GAClC,kBAAkB,MAAM,SAAS;GACjC,yBAAyB,MAAM,SAAS;GACxC,oBAAoB,MAAM,SAAS;GAGnC,kBAAkB,MAAM,WAAW;GACnC,uBAAuB,MAAM,WAAW;GAGxC,WAAW,MAAM,MAAM;GAGvB,cAAc,MAAM,OAAO;GAC3B,cAAc,MAAM,OAAO;GAC3B,iBAAiB,MAAM,OAAO;GAC9B,mBAAmB,MAAM,OAAO;GAGhC,wBAAwB,MAAM,WAAW;GACzC,4BAA4B,MAAM,WAAW;GAC7C,uBAAuB,MAAM,WAAW;GACxC,uBAAuB,MAAM,WAAW;GACxC,iCAAiC,MAAM,WAAW;GAGlD,aAAa,MAAM,QAAQ;GAC3B,sBAAsB,MAAM,QAAQ;GAGpC,WAAW,MAAM,MAAM;GACxB;AAGD,MAAI,MAAM,SACR;QAAK,MAAM,CAAC,OAAO,cAAc,OAAO,QAAQ,MAAM,QAAQ,CAC5D,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,UAAU,CAElD,KACE,OAAO,UAAU,YACjB,OAAO,UAAU,YACjB,OAAO,UAAU,UAEjB,YAAW,GAAG,MAAM,GAAG,SAAS;;AAOxC,SAAO,OAAO,YACZ,OAAO,QAAQ,WAAW,CAAC,QAAQ,CAAC,GAAG,WAAW,UAAU,OAAU,CACvE"}
+{"version":3,"file":"wide-event-emitter.js","names":[],"sources":["../../src/logging/wide-event-emitter.ts"],"sourcesContent":["import { logs, SeverityNumber } from \"@opentelemetry/api-logs\";\nimport type { WideEventData } from \"./wide-event\";\n\n/**\n * Emits WideEvents to OpenTelemetry as structured logs\n */\nexport class WideEventEmitter {\n  private logger = logs.getLogger(\"appkit\", \"1.0.0\");\n\n  /**\n   * Emit a WideEvent to OpenTelemetry.\n   * Fails silently to avoid crashing the application due to observability issues.\n   */\n  emit(event: WideEventData): void {\n    try {\n      const logRecord = {\n        timestamp: Date.parse(event.timestamp),\n        severityNumber: this.getSeverityNumber(event),\n        severityText: this.getSeverityText(event),\n        body: this.createLogBody(event),\n        attributes: this.createAttributes(event),\n      };\n\n      this.logger.emit(logRecord);\n    } catch {\n      // Silent fail - observability should never crash the application\n    }\n  }\n\n  /**\n   * Get OpenTelemetry severity number based on event data\n   */\n  private getSeverityNumber(event: WideEventData): SeverityNumber {\n    // Error level\n    if (event.error) {\n      return SeverityNumber.ERROR;\n    }\n\n    // Status code based\n    if (event.status_code) {\n      if (event.status_code >= 500) {\n        return SeverityNumber.ERROR;\n      }\n      if (event.status_code >= 400) {\n        return SeverityNumber.WARN;\n      }\n    }\n\n    // Check logs for errors/warnings\n    if (event.logs) {\n      const hasError = event.logs.some((log) => log.level === \"error\");\n      if (hasError) {\n        return SeverityNumber.ERROR;\n      }\n\n      const hasWarn = event.logs.some((log) => log.level === \"warn\");\n      if (hasWarn) {\n        return SeverityNumber.WARN;\n      }\n    }\n\n    return SeverityNumber.INFO;\n  }\n\n  /**\n   * Get severity text based on severity number\n   */\n  private getSeverityText(event: WideEventData): string {\n    const severityNumber = this.getSeverityNumber(event);\n\n    if (severityNumber >= SeverityNumber.ERROR) {\n      return \"ERROR\";\n    }\n    if (severityNumber >= SeverityNumber.WARN) {\n      return \"WARN\";\n    }\n    if (severityNumber >= SeverityNumber.INFO) {\n      return \"INFO\";\n    }\n    return \"DEBUG\";\n  }\n\n  /**\n   * Create log body from event data\n   */\n  private createLogBody(event: WideEventData): string {\n    const parts: string[] = [];\n\n    // HTTP request info\n    if (event.method && event.path) {\n      parts.push(`${event.method} ${event.path}`);\n    }\n\n    // Status code\n    if (event.status_code) {\n      parts.push(`→ ${event.status_code}`);\n    }\n\n    // Duration\n    if (event.duration_ms) {\n      parts.push(`(${event.duration_ms}ms)`);\n    }\n\n    // Component info\n    if (event.component) {\n      const componentStr = event.component.operation\n        ? `${event.component.name}.${event.component.operation}`\n        : event.component.name;\n      parts.push(`[${componentStr}]`);\n    }\n\n    // Error message\n    if (event.error) {\n      parts.push(`ERROR: ${event.error.message}`);\n    }\n\n    return parts.join(\" \");\n  }\n\n  /**\n   * Create OpenTelemetry attributes from event data\n   */\n  private createAttributes(\n    event: WideEventData,\n  ): Record<string, string | number | boolean | undefined> {\n    const attributes: Record<string, string | number | boolean | undefined> = {\n      // Request metadata\n      request_id: event.request_id,\n      trace_id: event.trace_id,\n\n      // HTTP attributes (OpenTelemetry semantic conventions)\n      \"http.method\": event.method,\n      \"http.route\": event.path,\n      \"http.status_code\": event.status_code,\n      \"http.request.duration_ms\": event.duration_ms,\n\n      // Service attributes\n      \"service.name\": event.service?.name,\n      \"service.version\": event.service?.version,\n      \"service.region\": event.service?.region,\n      \"service.deployment_id\": event.service?.deployment_id,\n      \"service.node_env\": event.service?.node_env,\n\n      // Component attributes\n      \"component.name\": event.component?.name,\n      \"component.operation\": event.component?.operation,\n\n      // User attributes\n      \"user.id\": event.user?.id,\n\n      // Error attributes\n      \"error.type\": event.error?.type,\n      \"error.code\": event.error?.code,\n      \"error.message\": event.error?.message,\n      \"error.retriable\": event.error?.retriable,\n\n      // Execution metadata\n      \"execution.timeout_ms\": event.execution?.timeout_ms,\n      \"execution.retry_attempts\": event.execution?.retry_attempts,\n      \"execution.cache_hit\": event.execution?.cache_hit,\n      \"execution.cache_key\": event.execution?.cache_key,\n      \"execution.cache_deduplication\": event.execution?.cache_deduplication,\n\n      // Stream metadata\n      \"stream.id\": event.stream?.stream_id,\n      \"stream.events_sent\": event.stream?.events_sent,\n\n      // Log count\n      log_count: event.logs?.length,\n    };\n\n    // Add custom context as attributes with scope prefix (no \"appkit\" prefix)\n    if (event.context) {\n      for (const [scope, scopeData] of Object.entries(event.context)) {\n        for (const [key, value] of Object.entries(scopeData)) {\n          // Only add primitive values\n          if (\n            typeof value === \"string\" ||\n            typeof value === \"number\" ||\n            typeof value === \"boolean\"\n          ) {\n            attributes[`${scope}.${key}`] = value;\n          }\n        }\n      }\n    }\n\n    // Remove undefined values\n    return Object.fromEntries(\n      Object.entries(attributes).filter(([_, value]) => value !== undefined),\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/logging/wide-event.js

@@ -5,6 +5,8 @@
 * - Fields are camelCase to match OpenTelemetry
 */
 var WideEvent = class {
+	data;
+	startTime;
 	constructor(requestId) {
 		this.startTime = Date.now();
 		this.data = {

package/dist/logging/wide-event.js.map

@@ -1 +1 @@
-{"version":3,"file":"wide-event.js","names":[],"sources":["../../src/logging/wide-event.ts"],"sourcesContent":["import type { LogLevel } from \"./types\";\n\n/**\n * WideEvent data interface\n * - Represents a single event for a request\n * - Fields are camelCase to match OpenTelemetry\n */\nexport interface WideEventData {\n  // request metadata\n  timestamp: string;\n  request_id: string;\n  trace_id?: string;\n  method?: string;\n  path?: string;\n  status_code?: number;\n  duration_ms?: number;\n\n  // service metadata\n  service?: {\n    name: string;\n    version: string;\n    region?: string;\n    deployment_id?: string;\n    node_env?: string;\n  };\n\n  // component metadata (plugin, connector, or service)\n  component?: {\n    name: string;\n    operation?: string;\n  };\n\n  // user metadata\n  user?: {\n    id?: string;\n    [key: string]: unknown;\n  };\n\n  // execution metadata\n  execution?: {\n    cache_hit?: boolean;\n    cache_key?: string;\n    cache_deduplication?: boolean;\n    retry_attempts?: number;\n    timeout_ms?: number;\n    [key: string]: unknown;\n  };\n\n  // stream metadata\n  stream?: {\n    stream_id?: string;\n    events_sent?: number;\n    buffer_size?: number;\n    reconnections?: number;\n    [key: string]: unknown;\n  };\n\n  // error metadata\n  error?: {\n    type: string;\n    code: string;\n    message: string;\n    retriable?: boolean;\n    cause?: string;\n  };\n\n  // log metadata\n  logs?: Array<{\n    level: LogLevel;\n    message: string;\n    timestamp: string;\n    context?: Record<string, unknown>;\n  }>;\n\n  /**\n   * Scoped context data\n   * Each scope (plugin, connector, service) can add its own namespaced data here.\n   * Example: { analytics: { query_key: \"...\"}, \"sql-warehouse\": { warehouse_id: \"...\"} }\n   */\n  context?: Record<string, Record<string, unknown>>;\n\n  [key: string]: unknown;\n}\n\n/**\n * WideEvent\n * - Represents a single event for a request\n * - Fields are camelCase to match OpenTelemetry\n */\nexport class WideEvent {\n  public data: WideEventData;\n  private startTime: number;\n\n  constructor(requestId: string) {\n    this.startTime = Date.now();\n    this.data = {\n      timestamp: new Date().toISOString(),\n      request_id: requestId,\n      service: {\n        name: \"appkit\",\n        version: process.env.npm_package_version || \"unknown\",\n        region: process.env.REGION,\n        deployment_id: process.env.DEPLOYMENT_ID,\n        node_env: process.env.NODE_ENV,\n      },\n      logs: [],\n      context: {},\n    };\n  }\n\n  /**\n   * Set a value in the event\n   * @param key - The key to set\n   * @param value - The value to set\n   * @returns The event\n   */\n  set<K extends keyof WideEventData>(key: K, value: WideEventData[K]): this {\n    if (typeof value === \"object\" && value !== null && !Array.isArray(value)) {\n      // merge objects\n      this.data[key] = {\n        ...(this.data[key] as object),\n        ...value,\n      } as WideEventData[K];\n    } else {\n      this.data[key] = value;\n    }\n    return this;\n  }\n\n  /**\n   * Set the component name and operation.\n   * Component can be a plugin, connector, or service.\n   * @param name - The name of the component (e.g., \"analytics\", \"sql-warehouse\", \"cache-manager\")\n   * @param operation - The operation being performed (e.g., \"query\", \"getOrExecute\")\n   * @returns The event\n   */\n  setComponent(name: string, operation?: string): this {\n    this.data.component = { name, operation };\n    return this;\n  }\n\n  /**\n   * Set the user context\n   * @param user - The user context\n   * @returns The event\n   */\n  setUser(user: WideEventData[\"user\"]): this {\n    this.data.user = { ...this.data.user, ...user };\n    return this;\n  }\n\n  /**\n   * Set the execution context\n   * @param execution - The execution context\n   * @returns The event\n   */\n  setExecution(execution: WideEventData[\"execution\"]): this {\n    this.data.execution = { ...this.data.execution, ...execution };\n    return this;\n  }\n\n  /**\n   * Set the stream context\n   * @param stream - The stream context\n   * @returns The event\n   */\n  setStream(stream: WideEventData[\"stream\"]): this {\n    this.data.stream = { ...this.data.stream, ...stream };\n    return this;\n  }\n\n  /**\n   * Set the error context\n   * @param error - The error context\n   * @returns The event\n   */\n  setError(error: Error): this {\n    const isAppKitError = \"code\" in error && \"statusCode\" in error;\n    const errorCause = (error as any).cause;\n\n    this.data.error = {\n      type: error.name,\n      code: isAppKitError ? (error as any).code : \"UNKNOWN_ERROR\",\n      message: error.message,\n      retriable: isAppKitError ? (error as any).isRetryable : false,\n      cause: errorCause ? String(errorCause) : undefined,\n    };\n\n    return this;\n  }\n\n  /**\n   * Add scoped context to the event\n   * @param scope - The scope name (plugin, connector, or service name)\n   * @param ctx - Context data to merge\n   * @example\n   * event.setContext(\"analytics\", { query_key: \"apps_list\", rows_returned: 100 });\n   * event.setContext(\"sql-warehouse\", { warehouse_id: \"1234567890\" });\n   */\n  setContext(scope: string, ctx: Record<string, unknown>): this {\n    if (!this.data.context) {\n      this.data.context = {};\n    }\n\n    this.data.context[scope] = {\n      ...this.data.context[scope],\n      ...ctx,\n    };\n\n    return this;\n  }\n\n  /**\n   * Add a log to the event\n   * @param level - The level of the log\n   * @param message - The message of the log\n   * @param context - The context of the log\n   * @returns The event\n   */\n  addLog(\n    level: LogLevel,\n    message: string,\n    context?: Record<string, unknown>,\n  ): this {\n    if (!this.data.logs) {\n      this.data.logs = [];\n    }\n\n    this.data.logs.push({\n      level,\n      message,\n      timestamp: new Date().toISOString(),\n      context,\n    });\n\n    // Keep only last 50 logs to prevent unbounded growth\n    if (this.data.logs.length > 50) {\n      this.data.logs = this.data.logs.slice(-50);\n    }\n\n    return this;\n  }\n\n  /**\n   * Finalize the event\n   * @param statusCode - The status code of the response\n   * @returns The event data\n   */\n  finalize(statusCode: number): WideEventData {\n    this.data.status_code = statusCode;\n    this.data.duration_ms = this.getDurationMs();\n    return this.data;\n  }\n\n  /**\n   * Get the duration of the event in milliseconds\n   * @returns The duration of the event in milliseconds\n   */\n  getDurationMs(): number {\n    return this.data.duration_ms || Date.now() - this.startTime;\n  }\n\n  /**\n   * Convert the event to a JSON object\n   * @returns The event data as a JSON object\n   */\n  toJSON(): WideEventData {\n    return this.data;\n  }\n}\n"],"mappings":";;;;;;AAyFA,IAAa,YAAb,MAAuB;CAIrB,YAAY,WAAmB;AAC7B,OAAK,YAAY,KAAK,KAAK;AAC3B,OAAK,OAAO;GACV,4BAAW,IAAI,MAAM,EAAC,aAAa;GACnC,YAAY;GACZ,SAAS;IACP,MAAM;IACN,SAAS,QAAQ,IAAI,uBAAuB;IAC5C,QAAQ,QAAQ,IAAI;IACpB,eAAe,QAAQ,IAAI;IAC3B,UAAU,QAAQ,IAAI;IACvB;GACD,MAAM,EAAE;GACR,SAAS,EAAE;GACZ;;;;;;;;CASH,IAAmC,KAAQ,OAA+B;AACxE,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,MAAM,CAEtE,MAAK,KAAK,OAAO;GACf,GAAI,KAAK,KAAK;GACd,GAAG;GACJ;MAED,MAAK,KAAK,OAAO;AAEnB,SAAO;;;;;;;;;CAUT,aAAa,MAAc,WAA0B;AACnD,OAAK,KAAK,YAAY;GAAE;GAAM;GAAW;AACzC,SAAO;;;;;;;CAQT,QAAQ,MAAmC;AACzC,OAAK,KAAK,OAAO;GAAE,GAAG,KAAK,KAAK;GAAM,GAAG;GAAM;AAC/C,SAAO;;;;;;;CAQT,aAAa,WAA6C;AACxD,OAAK,KAAK,YAAY;GAAE,GAAG,KAAK,KAAK;GAAW,GAAG;GAAW;AAC9D,SAAO;;;;;;;CAQT,UAAU,QAAuC;AAC/C,OAAK,KAAK,SAAS;GAAE,GAAG,KAAK,KAAK;GAAQ,GAAG;GAAQ;AACrD,SAAO;;;;;;;CAQT,SAAS,OAAoB;EAC3B,MAAM,gBAAgB,UAAU,SAAS,gBAAgB;EACzD,MAAM,aAAc,MAAc;AAElC,OAAK,KAAK,QAAQ;GAChB,MAAM,MAAM;GACZ,MAAM,gBAAiB,MAAc,OAAO;GAC5C,SAAS,MAAM;GACf,WAAW,gBAAiB,MAAc,cAAc;GACxD,OAAO,aAAa,OAAO,WAAW,GAAG;GAC1C;AAED,SAAO;;;;;;;;;;CAWT,WAAW,OAAe,KAAoC;AAC5D,MAAI,CAAC,KAAK,KAAK,QACb,MAAK,KAAK,UAAU,EAAE;AAGxB,OAAK,KAAK,QAAQ,SAAS;GACzB,GAAG,KAAK,KAAK,QAAQ;GACrB,GAAG;GACJ;AAED,SAAO;;;;;;;;;CAUT,OACE,OACA,SACA,SACM;AACN,MAAI,CAAC,KAAK,KAAK,KACb,MAAK,KAAK,OAAO,EAAE;AAGrB,OAAK,KAAK,KAAK,KAAK;GAClB;GACA;GACA,4BAAW,IAAI,MAAM,EAAC,aAAa;GACnC;GACD,CAAC;AAGF,MAAI,KAAK,KAAK,KAAK,SAAS,GAC1B,MAAK,KAAK,OAAO,KAAK,KAAK,KAAK,MAAM,IAAI;AAG5C,SAAO;;;;;;;CAQT,SAAS,YAAmC;AAC1C,OAAK,KAAK,cAAc;AACxB,OAAK,KAAK,cAAc,KAAK,eAAe;AAC5C,SAAO,KAAK;;;;;;CAOd,gBAAwB;AACtB,SAAO,KAAK,KAAK,eAAe,KAAK,KAAK,GAAG,KAAK;;;;;;CAOpD,SAAwB;AACtB,SAAO,KAAK"}
+{"version":3,"file":"wide-event.js","names":[],"sources":["../../src/logging/wide-event.ts"],"sourcesContent":["import type { LogLevel } from \"./types\";\n\n/**\n * WideEvent data interface\n * - Represents a single event for a request\n * - Fields are camelCase to match OpenTelemetry\n */\nexport interface WideEventData {\n  // request metadata\n  timestamp: string;\n  request_id: string;\n  trace_id?: string;\n  method?: string;\n  path?: string;\n  status_code?: number;\n  duration_ms?: number;\n\n  // service metadata\n  service?: {\n    name: string;\n    version: string;\n    region?: string;\n    deployment_id?: string;\n    node_env?: string;\n  };\n\n  // component metadata (plugin, connector, or service)\n  component?: {\n    name: string;\n    operation?: string;\n  };\n\n  // user metadata\n  user?: {\n    id?: string;\n    [key: string]: unknown;\n  };\n\n  // execution metadata\n  execution?: {\n    cache_hit?: boolean;\n    cache_key?: string;\n    cache_deduplication?: boolean;\n    retry_attempts?: number;\n    timeout_ms?: number;\n    [key: string]: unknown;\n  };\n\n  // stream metadata\n  stream?: {\n    stream_id?: string;\n    events_sent?: number;\n    buffer_size?: number;\n    reconnections?: number;\n    [key: string]: unknown;\n  };\n\n  // error metadata\n  error?: {\n    type: string;\n    code: string;\n    message: string;\n    retriable?: boolean;\n    cause?: string;\n  };\n\n  // log metadata\n  logs?: Array<{\n    level: LogLevel;\n    message: string;\n    timestamp: string;\n    context?: Record<string, unknown>;\n  }>;\n\n  /**\n   * Scoped context data\n   * Each scope (plugin, connector, service) can add its own namespaced data here.\n   * Example: { analytics: { query_key: \"...\"}, \"sql-warehouse\": { warehouse_id: \"...\"} }\n   */\n  context?: Record<string, Record<string, unknown>>;\n\n  [key: string]: unknown;\n}\n\n/**\n * WideEvent\n * - Represents a single event for a request\n * - Fields are camelCase to match OpenTelemetry\n */\nexport class WideEvent {\n  public data: WideEventData;\n  private startTime: number;\n\n  constructor(requestId: string) {\n    this.startTime = Date.now();\n    this.data = {\n      timestamp: new Date().toISOString(),\n      request_id: requestId,\n      service: {\n        name: \"appkit\",\n        version: process.env.npm_package_version || \"unknown\",\n        region: process.env.REGION,\n        deployment_id: process.env.DEPLOYMENT_ID,\n        node_env: process.env.NODE_ENV,\n      },\n      logs: [],\n      context: {},\n    };\n  }\n\n  /**\n   * Set a value in the event\n   * @param key - The key to set\n   * @param value - The value to set\n   * @returns The event\n   */\n  set<K extends keyof WideEventData>(key: K, value: WideEventData[K]): this {\n    if (typeof value === \"object\" && value !== null && !Array.isArray(value)) {\n      // merge objects\n      this.data[key] = {\n        ...(this.data[key] as object),\n        ...value,\n      } as WideEventData[K];\n    } else {\n      this.data[key] = value;\n    }\n    return this;\n  }\n\n  /**\n   * Set the component name and operation.\n   * Component can be a plugin, connector, or service.\n   * @param name - The name of the component (e.g., \"analytics\", \"sql-warehouse\", \"cache-manager\")\n   * @param operation - The operation being performed (e.g., \"query\", \"getOrExecute\")\n   * @returns The event\n   */\n  setComponent(name: string, operation?: string): this {\n    this.data.component = { name, operation };\n    return this;\n  }\n\n  /**\n   * Set the user context\n   * @param user - The user context\n   * @returns The event\n   */\n  setUser(user: WideEventData[\"user\"]): this {\n    this.data.user = { ...this.data.user, ...user };\n    return this;\n  }\n\n  /**\n   * Set the execution context\n   * @param execution - The execution context\n   * @returns The event\n   */\n  setExecution(execution: WideEventData[\"execution\"]): this {\n    this.data.execution = { ...this.data.execution, ...execution };\n    return this;\n  }\n\n  /**\n   * Set the stream context\n   * @param stream - The stream context\n   * @returns The event\n   */\n  setStream(stream: WideEventData[\"stream\"]): this {\n    this.data.stream = { ...this.data.stream, ...stream };\n    return this;\n  }\n\n  /**\n   * Set the error context\n   * @param error - The error context\n   * @returns The event\n   */\n  setError(error: Error): this {\n    const isAppKitError = \"code\" in error && \"statusCode\" in error;\n    const errorCause = (error as any).cause;\n\n    this.data.error = {\n      type: error.name,\n      code: isAppKitError ? (error as any).code : \"UNKNOWN_ERROR\",\n      message: error.message,\n      retriable: isAppKitError ? (error as any).isRetryable : false,\n      cause: errorCause ? String(errorCause) : undefined,\n    };\n\n    return this;\n  }\n\n  /**\n   * Add scoped context to the event\n   * @param scope - The scope name (plugin, connector, or service name)\n   * @param ctx - Context data to merge\n   * @example\n   * event.setContext(\"analytics\", { query_key: \"apps_list\", rows_returned: 100 });\n   * event.setContext(\"sql-warehouse\", { warehouse_id: \"1234567890\" });\n   */\n  setContext(scope: string, ctx: Record<string, unknown>): this {\n    if (!this.data.context) {\n      this.data.context = {};\n    }\n\n    this.data.context[scope] = {\n      ...this.data.context[scope],\n      ...ctx,\n    };\n\n    return this;\n  }\n\n  /**\n   * Add a log to the event\n   * @param level - The level of the log\n   * @param message - The message of the log\n   * @param context - The context of the log\n   * @returns The event\n   */\n  addLog(\n    level: LogLevel,\n    message: string,\n    context?: Record<string, unknown>,\n  ): this {\n    if (!this.data.logs) {\n      this.data.logs = [];\n    }\n\n    this.data.logs.push({\n      level,\n      message,\n      timestamp: new Date().toISOString(),\n      context,\n    });\n\n    // Keep only last 50 logs to prevent unbounded growth\n    if (this.data.logs.length > 50) {\n      this.data.logs = this.data.logs.slice(-50);\n    }\n\n    return this;\n  }\n\n  /**\n   * Finalize the event\n   * @param statusCode - The status code of the response\n   * @returns The event data\n   */\n  finalize(statusCode: number): WideEventData {\n    this.data.status_code = statusCode;\n    this.data.duration_ms = this.getDurationMs();\n    return this.data;\n  }\n\n  /**\n   * Get the duration of the event in milliseconds\n   * @returns The duration of the event in milliseconds\n   */\n  getDurationMs(): number {\n    return this.data.duration_ms || Date.now() - this.startTime;\n  }\n\n  /**\n   * Convert the event to a JSON object\n   * @returns The event data as a JSON object\n   */\n  toJSON(): WideEventData {\n    return this.data;\n  }\n}\n"],"mappings":";;;;;;AAyFA,IAAa,YAAb,MAAuB;CACrB,AAAO;CACP,AAAQ;CAER,YAAY,WAAmB;AAC7B,OAAK,YAAY,KAAK,KAAK;AAC3B,OAAK,OAAO;GACV,4BAAW,IAAI,MAAM,EAAC,aAAa;GACnC,YAAY;GACZ,SAAS;IACP,MAAM;IACN,SAAS,QAAQ,IAAI,uBAAuB;IAC5C,QAAQ,QAAQ,IAAI;IACpB,eAAe,QAAQ,IAAI;IAC3B,UAAU,QAAQ,IAAI;IACvB;GACD,MAAM,EAAE;GACR,SAAS,EAAE;GACZ;;;;;;;;CASH,IAAmC,KAAQ,OAA+B;AACxE,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,MAAM,CAEtE,MAAK,KAAK,OAAO;GACf,GAAI,KAAK,KAAK;GACd,GAAG;GACJ;MAED,MAAK,KAAK,OAAO;AAEnB,SAAO;;;;;;;;;CAUT,aAAa,MAAc,WAA0B;AACnD,OAAK,KAAK,YAAY;GAAE;GAAM;GAAW;AACzC,SAAO;;;;;;;CAQT,QAAQ,MAAmC;AACzC,OAAK,KAAK,OAAO;GAAE,GAAG,KAAK,KAAK;GAAM,GAAG;GAAM;AAC/C,SAAO;;;;;;;CAQT,aAAa,WAA6C;AACxD,OAAK,KAAK,YAAY;GAAE,GAAG,KAAK,KAAK;GAAW,GAAG;GAAW;AAC9D,SAAO;;;;;;;CAQT,UAAU,QAAuC;AAC/C,OAAK,KAAK,SAAS;GAAE,GAAG,KAAK,KAAK;GAAQ,GAAG;GAAQ;AACrD,SAAO;;;;;;;CAQT,SAAS,OAAoB;EAC3B,MAAM,gBAAgB,UAAU,SAAS,gBAAgB;EACzD,MAAM,aAAc,MAAc;AAElC,OAAK,KAAK,QAAQ;GAChB,MAAM,MAAM;GACZ,MAAM,gBAAiB,MAAc,OAAO;GAC5C,SAAS,MAAM;GACf,WAAW,gBAAiB,MAAc,cAAc;GACxD,OAAO,aAAa,OAAO,WAAW,GAAG;GAC1C;AAED,SAAO;;;;;;;;;;CAWT,WAAW,OAAe,KAAoC;AAC5D,MAAI,CAAC,KAAK,KAAK,QACb,MAAK,KAAK,UAAU,EAAE;AAGxB,OAAK,KAAK,QAAQ,SAAS;GACzB,GAAG,KAAK,KAAK,QAAQ;GACrB,GAAG;GACJ;AAED,SAAO;;;;;;;;;CAUT,OACE,OACA,SACA,SACM;AACN,MAAI,CAAC,KAAK,KAAK,KACb,MAAK,KAAK,OAAO,EAAE;AAGrB,OAAK,KAAK,KAAK,KAAK;GAClB;GACA;GACA,4BAAW,IAAI,MAAM,EAAC,aAAa;GACnC;GACD,CAAC;AAGF,MAAI,KAAK,KAAK,KAAK,SAAS,GAC1B,MAAK,KAAK,OAAO,KAAK,KAAK,KAAK,MAAM,IAAI;AAG5C,SAAO;;;;;;;CAQT,SAAS,YAAmC;AAC1C,OAAK,KAAK,cAAc;AACxB,OAAK,KAAK,cAAc,KAAK,eAAe;AAC5C,SAAO,KAAK;;;;;;CAOd,gBAAwB;AACtB,SAAO,KAAK,KAAK,eAAe,KAAK,KAAK,GAAG,KAAK;;;;;;CAOpD,SAAwB;AACtB,SAAO,KAAK"}

package/dist/plugin/dev-reader.d.ts

@@ -14,6 +14,7 @@ declare class DevFileReader {
   static getInstance(): DevFileReader;
   registerTunnelGetter(getter: TunnelConnectionGetter): void;
   readFile(filePath: string, req: express0.Request): Promise<string>;
+  readdir(dirPath: string, req: express0.Request): Promise<string[]>;
 }
 //#endregion
 export { DevFileReader };

package/dist/plugin/dev-reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev-reader.d.ts","names":[],"sources":["../../src/plugin/dev-reader.ts"],"sourcesContent":[],"mappings":";;;;KAQK,sBAAA,SAAsB,QAAA,CACF,YACpB;;;AAT0C;;AAOpB,cAQd,aAAA,CAPY;iBACpB,QAAA;EAAgB,QAAA,mBAAA;EAMR,QAAA,WAAa,CAAA;EAAA,OAAA,WAAA,CAAA,CAAA,EAMF,aANE;sBAMF,CAAA,MAAA,EA+BO,sBA/BP,CAAA,EAAA,IAAA;UA+BO,CAAA,QAAA,EAAA,MAAA,EAAA,GAAA,EAAsB,QAAA,CAM1B,OANI,CAAA,EAO1B,OAP0B,CAAA,MAAA,CAAA"}
+{"version":3,"file":"dev-reader.d.ts","names":[],"sources":["../../src/plugin/dev-reader.ts"],"sourcesContent":[],"mappings":";;;;KAQK,sBAAA,SAAsB,QAAA,CACF,YACpB;;;AAT0C;;AAOpB,cAQd,aAAA,CAPY;iBACpB,QAAA;EAAgB,QAAA,mBAAA;EAMR,QAAA,WAAa,CAAA;EAAA,OAAA,WAAA,CAAA,CAAA,EAMF,aANE;sBAMF,CAAA,MAAA,EA+BO,sBA/BP,CAAA,EAAA,IAAA;UA+BO,CAAA,QAAA,EAAA,MAAA,EAAA,GAAA,EAAsB,QAAA,CAM1B,OANI,CAAA,EAO1B,OAP0B,CAAA,MAAA,CAAA;SAAsB,CAAA,OAM1B,EAAA,MAAA,EAAA,GAAA,EACf,QAAA,CAiCe,OAlCA,CAAA,EAmCtB,OAnCsB,CAAA,MAAA,EAAA,CAAA"}

package/dist/plugin/dev-reader.js

@@ -12,12 +12,9 @@ const logger = createLogger("plugin:dev-reader");
 * through the WebSocket tunnel.
 */
 var DevFileReader = class DevFileReader {
-	static {
-		this.instance = null;
-	}
-	constructor() {
-		this.getTunnelForRequest = null;
-	}
+	static instance = null;
+	getTunnelForRequest = null;
+	constructor() {}
 	static getInstance() {
 		if (!DevFileReader.instance) DevFileReader.instance = new Proxy(new DevFileReader(), {
 			get(target, prop, receiver) {
@@ -61,6 +58,44 @@ var DevFileReader = class DevFileReader {
 			}));
 		});
 	}
+	async readdir(dirPath, req) {
+		if (!this.getTunnelForRequest) throw TunnelError.getterNotRegistered();
+		const tunnel = this.getTunnelForRequest(req);
+		if (!tunnel) throw TunnelError.noConnection();
+		const { ws, pendingFileReads } = tunnel;
+		const requestId = randomUUID();
+		return new Promise((resolve, reject) => {
+			const timeout = setTimeout(() => {
+				pendingFileReads.delete(requestId);
+				reject(/* @__PURE__ */ new Error(`Directory read timeout: ${dirPath}`));
+			}, 1e4);
+			pendingFileReads.set(requestId, {
+				resolve: (data) => {
+					try {
+						const files = JSON.parse(data);
+						if (!Array.isArray(files)) {
+							reject(/* @__PURE__ */ new Error("Invalid directory listing format: expected array, got " + typeof files));
+							return;
+						}
+						if (!files.every((f) => typeof f === "string")) {
+							reject(/* @__PURE__ */ new Error("Invalid directory listing format: expected array of strings"));
+							return;
+						}
+						resolve(files);
+					} catch (error) {
+						reject(/* @__PURE__ */ new Error(`Failed to parse directory listing: ${error.message}`));
+					}
+				},
+				reject,
+				timeout
+			});
+			ws.send(JSON.stringify({
+				type: "dir:list",
+				requestId,
+				path: dirPath
+			}));
+		});
+	}
 };
 
 //#endregion

package/dist/plugin/dev-reader.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev-reader.js","names":[],"sources":["../../src/plugin/dev-reader.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport type { TunnelConnection } from \"shared\";\nimport { isRemoteTunnelAllowedByEnv } from \"@/server/remote-tunnel/gate\";\nimport { TunnelError } from \"../errors\";\nimport { createLogger } from \"../logging/logger\";\n\nconst logger = createLogger(\"plugin:dev-reader\");\n\ntype TunnelConnectionGetter = (\n  req: import(\"express\").Request,\n) => TunnelConnection | null;\n\n/**\n * This class is used to read files from the local filesystem in dev mode\n * through the WebSocket tunnel.\n */\nexport class DevFileReader {\n  private static instance: DevFileReader | null = null;\n  private getTunnelForRequest: TunnelConnectionGetter | null = null;\n\n  private constructor() {}\n\n  static getInstance(): DevFileReader {\n    if (!DevFileReader.instance) {\n      DevFileReader.instance = new Proxy(new DevFileReader(), {\n        /**\n         * We proxy the reader to return a noop function if the remote server is disabled.\n         */\n        get(target, prop, receiver) {\n          if (isRemoteTunnelAllowedByEnv()) {\n            return Reflect.get(target, prop, receiver);\n          }\n\n          const value = Reflect.get(target, prop, receiver);\n\n          if (typeof value === \"function\") {\n            return function noop() {\n              logger.debug(\"Noop: %s (remote server disabled)\", String(prop));\n              return Promise.resolve(\"\");\n            };\n          }\n\n          return value;\n        },\n        set(target, prop, value, receiver) {\n          return Reflect.set(target, prop, value, receiver);\n        },\n      });\n    }\n\n    return DevFileReader.instance;\n  }\n\n  registerTunnelGetter(getter: TunnelConnectionGetter) {\n    this.getTunnelForRequest = getter;\n  }\n\n  async readFile(\n    filePath: string,\n    req: import(\"express\").Request,\n  ): Promise<string> {\n    if (!this.getTunnelForRequest) {\n      throw TunnelError.getterNotRegistered();\n    }\n    const tunnel = this.getTunnelForRequest(req);\n\n    if (!tunnel) {\n      throw TunnelError.noConnection();\n    }\n\n    const { ws, pendingFileReads } = tunnel;\n    const requestId = randomUUID();\n\n    return new Promise((resolve, reject) => {\n      const timeout = setTimeout(() => {\n        pendingFileReads.delete(requestId);\n        reject(new Error(`File read timeout: ${filePath}`));\n      }, 10000);\n\n      pendingFileReads.set(requestId, { resolve, reject, timeout });\n\n      ws.send(\n        JSON.stringify({\n          type: \"file:read\",\n          requestId,\n          path: filePath,\n        }),\n      );\n    });\n  }\n}\n"],"mappings":";;;;;;;aAGwC;AAGxC,MAAM,SAAS,aAAa,oBAAoB;;;;;AAUhD,IAAa,gBAAb,MAAa,cAAc;;kBACuB;;CAGhD,AAAQ,cAAc;6BAFuC;;CAI7D,OAAO,cAA6B;AAClC,MAAI,CAAC,cAAc,SACjB,eAAc,WAAW,IAAI,MAAM,IAAI,eAAe,EAAE;GAItD,IAAI,QAAQ,MAAM,UAAU;AAC1B,QAAI,4BAA4B,CAC9B,QAAO,QAAQ,IAAI,QAAQ,MAAM,SAAS;IAG5C,MAAM,QAAQ,QAAQ,IAAI,QAAQ,MAAM,SAAS;AAEjD,QAAI,OAAO,UAAU,WACnB,QAAO,SAAS,OAAO;AACrB,YAAO,MAAM,qCAAqC,OAAO,KAAK,CAAC;AAC/D,YAAO,QAAQ,QAAQ,GAAG;;AAI9B,WAAO;;GAET,IAAI,QAAQ,MAAM,OAAO,UAAU;AACjC,WAAO,QAAQ,IAAI,QAAQ,MAAM,OAAO,SAAS;;GAEpD,CAAC;AAGJ,SAAO,cAAc;;CAGvB,qBAAqB,QAAgC;AACnD,OAAK,sBAAsB;;CAG7B,MAAM,SACJ,UACA,KACiB;AACjB,MAAI,CAAC,KAAK,oBACR,OAAM,YAAY,qBAAqB;EAEzC,MAAM,SAAS,KAAK,oBAAoB,IAAI;AAE5C,MAAI,CAAC,OACH,OAAM,YAAY,cAAc;EAGlC,MAAM,EAAE,IAAI,qBAAqB;EACjC,MAAM,YAAY,YAAY;AAE9B,SAAO,IAAI,SAAS,SAAS,WAAW;GACtC,MAAM,UAAU,iBAAiB;AAC/B,qBAAiB,OAAO,UAAU;AAClC,2BAAO,IAAI,MAAM,sBAAsB,WAAW,CAAC;MAClD,IAAM;AAET,oBAAiB,IAAI,WAAW;IAAE;IAAS;IAAQ;IAAS,CAAC;AAE7D,MAAG,KACD,KAAK,UAAU;IACb,MAAM;IACN;IACA,MAAM;IACP,CAAC,CACH;IACD"}
+{"version":3,"file":"dev-reader.js","names":[],"sources":["../../src/plugin/dev-reader.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport type { TunnelConnection } from \"shared\";\nimport { isRemoteTunnelAllowedByEnv } from \"@/server/remote-tunnel/gate\";\nimport { TunnelError } from \"../errors\";\nimport { createLogger } from \"../logging/logger\";\n\nconst logger = createLogger(\"plugin:dev-reader\");\n\ntype TunnelConnectionGetter = (\n  req: import(\"express\").Request,\n) => TunnelConnection | null;\n\n/**\n * This class is used to read files from the local filesystem in dev mode\n * through the WebSocket tunnel.\n */\nexport class DevFileReader {\n  private static instance: DevFileReader | null = null;\n  private getTunnelForRequest: TunnelConnectionGetter | null = null;\n\n  private constructor() {}\n\n  static getInstance(): DevFileReader {\n    if (!DevFileReader.instance) {\n      DevFileReader.instance = new Proxy(new DevFileReader(), {\n        /**\n         * We proxy the reader to return a noop function if the remote server is disabled.\n         */\n        get(target, prop, receiver) {\n          if (isRemoteTunnelAllowedByEnv()) {\n            return Reflect.get(target, prop, receiver);\n          }\n\n          const value = Reflect.get(target, prop, receiver);\n\n          if (typeof value === \"function\") {\n            return function noop() {\n              logger.debug(\"Noop: %s (remote server disabled)\", String(prop));\n              return Promise.resolve(\"\");\n            };\n          }\n\n          return value;\n        },\n        set(target, prop, value, receiver) {\n          return Reflect.set(target, prop, value, receiver);\n        },\n      });\n    }\n\n    return DevFileReader.instance;\n  }\n\n  registerTunnelGetter(getter: TunnelConnectionGetter) {\n    this.getTunnelForRequest = getter;\n  }\n\n  async readFile(\n    filePath: string,\n    req: import(\"express\").Request,\n  ): Promise<string> {\n    if (!this.getTunnelForRequest) {\n      throw TunnelError.getterNotRegistered();\n    }\n    const tunnel = this.getTunnelForRequest(req);\n\n    if (!tunnel) {\n      throw TunnelError.noConnection();\n    }\n\n    const { ws, pendingFileReads } = tunnel;\n    const requestId = randomUUID();\n\n    return new Promise((resolve, reject) => {\n      const timeout = setTimeout(() => {\n        pendingFileReads.delete(requestId);\n        reject(new Error(`File read timeout: ${filePath}`));\n      }, 10000);\n\n      pendingFileReads.set(requestId, { resolve, reject, timeout });\n\n      ws.send(\n        JSON.stringify({\n          type: \"file:read\",\n          requestId,\n          path: filePath,\n        }),\n      );\n    });\n  }\n\n  async readdir(\n    dirPath: string,\n    req: import(\"express\").Request,\n  ): Promise<string[]> {\n    if (!this.getTunnelForRequest) {\n      throw TunnelError.getterNotRegistered();\n    }\n    const tunnel = this.getTunnelForRequest(req);\n\n    if (!tunnel) {\n      throw TunnelError.noConnection();\n    }\n\n    const { ws, pendingFileReads } = tunnel;\n    const requestId = randomUUID();\n\n    return new Promise((resolve, reject) => {\n      const timeout = setTimeout(() => {\n        pendingFileReads.delete(requestId);\n        reject(new Error(`Directory read timeout: ${dirPath}`));\n      }, 10000);\n\n      pendingFileReads.set(requestId, {\n        resolve: (data: string) => {\n          try {\n            const files = JSON.parse(data);\n            // Validate it's an array of strings\n            if (!Array.isArray(files)) {\n              reject(\n                new Error(\n                  \"Invalid directory listing format: expected array, got \" +\n                    typeof files,\n                ),\n              );\n              return;\n            }\n            if (!files.every((f) => typeof f === \"string\")) {\n              reject(\n                new Error(\n                  \"Invalid directory listing format: expected array of strings\",\n                ),\n              );\n              return;\n            }\n            resolve(files);\n          } catch (error) {\n            reject(\n              new Error(\n                `Failed to parse directory listing: ${(error as Error).message}`,\n              ),\n            );\n          }\n        },\n        reject,\n        timeout,\n      });\n\n      ws.send(\n        JSON.stringify({\n          type: \"dir:list\",\n          requestId,\n          path: dirPath,\n        }),\n      );\n    });\n  }\n}\n"],"mappings":";;;;;;;aAGwC;AAGxC,MAAM,SAAS,aAAa,oBAAoB;;;;;AAUhD,IAAa,gBAAb,MAAa,cAAc;CACzB,OAAe,WAAiC;CAChD,AAAQ,sBAAqD;CAE7D,AAAQ,cAAc;CAEtB,OAAO,cAA6B;AAClC,MAAI,CAAC,cAAc,SACjB,eAAc,WAAW,IAAI,MAAM,IAAI,eAAe,EAAE;GAItD,IAAI,QAAQ,MAAM,UAAU;AAC1B,QAAI,4BAA4B,CAC9B,QAAO,QAAQ,IAAI,QAAQ,MAAM,SAAS;IAG5C,MAAM,QAAQ,QAAQ,IAAI,QAAQ,MAAM,SAAS;AAEjD,QAAI,OAAO,UAAU,WACnB,QAAO,SAAS,OAAO;AACrB,YAAO,MAAM,qCAAqC,OAAO,KAAK,CAAC;AAC/D,YAAO,QAAQ,QAAQ,GAAG;;AAI9B,WAAO;;GAET,IAAI,QAAQ,MAAM,OAAO,UAAU;AACjC,WAAO,QAAQ,IAAI,QAAQ,MAAM,OAAO,SAAS;;GAEpD,CAAC;AAGJ,SAAO,cAAc;;CAGvB,qBAAqB,QAAgC;AACnD,OAAK,sBAAsB;;CAG7B,MAAM,SACJ,UACA,KACiB;AACjB,MAAI,CAAC,KAAK,oBACR,OAAM,YAAY,qBAAqB;EAEzC,MAAM,SAAS,KAAK,oBAAoB,IAAI;AAE5C,MAAI,CAAC,OACH,OAAM,YAAY,cAAc;EAGlC,MAAM,EAAE,IAAI,qBAAqB;EACjC,MAAM,YAAY,YAAY;AAE9B,SAAO,IAAI,SAAS,SAAS,WAAW;GACtC,MAAM,UAAU,iBAAiB;AAC/B,qBAAiB,OAAO,UAAU;AAClC,2BAAO,IAAI,MAAM,sBAAsB,WAAW,CAAC;MAClD,IAAM;AAET,oBAAiB,IAAI,WAAW;IAAE;IAAS;IAAQ;IAAS,CAAC;AAE7D,MAAG,KACD,KAAK,UAAU;IACb,MAAM;IACN;IACA,MAAM;IACP,CAAC,CACH;IACD;;CAGJ,MAAM,QACJ,SACA,KACmB;AACnB,MAAI,CAAC,KAAK,oBACR,OAAM,YAAY,qBAAqB;EAEzC,MAAM,SAAS,KAAK,oBAAoB,IAAI;AAE5C,MAAI,CAAC,OACH,OAAM,YAAY,cAAc;EAGlC,MAAM,EAAE,IAAI,qBAAqB;EACjC,MAAM,YAAY,YAAY;AAE9B,SAAO,IAAI,SAAS,SAAS,WAAW;GACtC,MAAM,UAAU,iBAAiB;AAC/B,qBAAiB,OAAO,UAAU;AAClC,2BAAO,IAAI,MAAM,2BAA2B,UAAU,CAAC;MACtD,IAAM;AAET,oBAAiB,IAAI,WAAW;IAC9B,UAAU,SAAiB;AACzB,SAAI;MACF,MAAM,QAAQ,KAAK,MAAM,KAAK;AAE9B,UAAI,CAAC,MAAM,QAAQ,MAAM,EAAE;AACzB,8BACE,IAAI,MACF,2DACE,OAAO,MACV,CACF;AACD;;AAEF,UAAI,CAAC,MAAM,OAAO,MAAM,OAAO,MAAM,SAAS,EAAE;AAC9C,8BACE,IAAI,MACF,8DACD,CACF;AACD;;AAEF,cAAQ,MAAM;cACP,OAAO;AACd,6BACE,IAAI,MACF,sCAAuC,MAAgB,UACxD,CACF;;;IAGL;IACA;IACD,CAAC;AAEF,MAAG,KACD,KAAK,UAAU;IACb,MAAM;IACN;IACA,MAAM;IACP,CAAC,CACH;IACD"}

package/dist/plugin/interceptors/retry.js

@@ -3,6 +3,9 @@ import { createLogger } from "../../logging/logger.js";
 //#region src/plugin/interceptors/retry.ts
 const logger = createLogger("interceptors:retry");
 var RetryInterceptor = class {
+	attempts;
+	initialDelay;
+	maxDelay;
 	constructor(config) {
 		this.attempts = config.attempts ?? 3;
 		this.initialDelay = config.initialDelay ?? 1e3;

package/dist/plugin/interceptors/retry.js.map

@@ -1 +1 @@
-{"version":3,"file":"retry.js","names":[],"sources":["../../../src/plugin/interceptors/retry.ts"],"sourcesContent":["import type { RetryConfig } from \"shared\";\nimport { createLogger } from \"../../logging/logger\";\nimport type { ExecutionInterceptor, InterceptorContext } from \"./types\";\n\nconst logger = createLogger(\"interceptors:retry\");\n\n// interceptor to handle retry logic\nexport class RetryInterceptor implements ExecutionInterceptor {\n  private attempts: number;\n  private initialDelay: number;\n  private maxDelay: number;\n\n  constructor(config: RetryConfig) {\n    this.attempts = config.attempts ?? 3;\n    this.initialDelay = config.initialDelay ?? 1000;\n    this.maxDelay = config.maxDelay ?? 30000;\n  }\n\n  async intercept<T>(\n    fn: () => Promise<T>,\n    context: InterceptorContext,\n  ): Promise<T> {\n    let lastError: Error | unknown;\n\n    for (let attempt = 1; attempt <= this.attempts; attempt++) {\n      try {\n        const result = await fn();\n\n        if (attempt > 1) {\n          logger.event()?.setExecution({\n            retry_attempts: attempt - 1,\n          });\n        }\n\n        return result;\n      } catch (error) {\n        lastError = error;\n\n        // last attempt, rethrow the error\n        if (attempt === this.attempts) {\n          logger.event()?.setExecution({\n            retry_attempts: attempt - 1,\n          });\n          throw error;\n        }\n\n        // don't retry if was already aborted\n        if (context.signal?.aborted) {\n          throw error;\n        }\n\n        const delay = this.calculateDelay(attempt);\n        await this.sleep(delay);\n      }\n    }\n\n    // type guard\n    throw lastError;\n  }\n\n  private calculateDelay(attempt: number): number {\n    // exponential backoff\n    const delay = this.initialDelay * 2 ** (attempt - 1);\n\n    // max delay cap\n    return Math.min(delay, this.maxDelay);\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n"],"mappings":";;;AAIA,MAAM,SAAS,aAAa,qBAAqB;AAGjD,IAAa,mBAAb,MAA8D;CAK5D,YAAY,QAAqB;AAC/B,OAAK,WAAW,OAAO,YAAY;AACnC,OAAK,eAAe,OAAO,gBAAgB;AAC3C,OAAK,WAAW,OAAO,YAAY;;CAGrC,MAAM,UACJ,IACA,SACY;EACZ,IAAI;AAEJ,OAAK,IAAI,UAAU,GAAG,WAAW,KAAK,UAAU,UAC9C,KAAI;GACF,MAAM,SAAS,MAAM,IAAI;AAEzB,OAAI,UAAU,EACZ,QAAO,OAAO,EAAE,aAAa,EAC3B,gBAAgB,UAAU,GAC3B,CAAC;AAGJ,UAAO;WACA,OAAO;AACd,eAAY;AAGZ,OAAI,YAAY,KAAK,UAAU;AAC7B,WAAO,OAAO,EAAE,aAAa,EAC3B,gBAAgB,UAAU,GAC3B,CAAC;AACF,UAAM;;AAIR,OAAI,QAAQ,QAAQ,QAClB,OAAM;GAGR,MAAM,QAAQ,KAAK,eAAe,QAAQ;AAC1C,SAAM,KAAK,MAAM,MAAM;;AAK3B,QAAM;;CAGR,AAAQ,eAAe,SAAyB;EAE9C,MAAM,QAAQ,KAAK,eAAe,MAAM,UAAU;AAGlD,SAAO,KAAK,IAAI,OAAO,KAAK,SAAS;;CAGvC,AAAQ,MAAM,IAA2B;AACvC,SAAO,IAAI,SAAS,YAAY,WAAW,SAAS,GAAG,CAAC"}
+{"version":3,"file":"retry.js","names":[],"sources":["../../../src/plugin/interceptors/retry.ts"],"sourcesContent":["import type { RetryConfig } from \"shared\";\nimport { createLogger } from \"../../logging/logger\";\nimport type { ExecutionInterceptor, InterceptorContext } from \"./types\";\n\nconst logger = createLogger(\"interceptors:retry\");\n\n// interceptor to handle retry logic\nexport class RetryInterceptor implements ExecutionInterceptor {\n  private attempts: number;\n  private initialDelay: number;\n  private maxDelay: number;\n\n  constructor(config: RetryConfig) {\n    this.attempts = config.attempts ?? 3;\n    this.initialDelay = config.initialDelay ?? 1000;\n    this.maxDelay = config.maxDelay ?? 30000;\n  }\n\n  async intercept<T>(\n    fn: () => Promise<T>,\n    context: InterceptorContext,\n  ): Promise<T> {\n    let lastError: Error | unknown;\n\n    for (let attempt = 1; attempt <= this.attempts; attempt++) {\n      try {\n        const result = await fn();\n\n        if (attempt > 1) {\n          logger.event()?.setExecution({\n            retry_attempts: attempt - 1,\n          });\n        }\n\n        return result;\n      } catch (error) {\n        lastError = error;\n\n        // last attempt, rethrow the error\n        if (attempt === this.attempts) {\n          logger.event()?.setExecution({\n            retry_attempts: attempt - 1,\n          });\n          throw error;\n        }\n\n        // don't retry if was already aborted\n        if (context.signal?.aborted) {\n          throw error;\n        }\n\n        const delay = this.calculateDelay(attempt);\n        await this.sleep(delay);\n      }\n    }\n\n    // type guard\n    throw lastError;\n  }\n\n  private calculateDelay(attempt: number): number {\n    // exponential backoff\n    const delay = this.initialDelay * 2 ** (attempt - 1);\n\n    // max delay cap\n    return Math.min(delay, this.maxDelay);\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n"],"mappings":";;;AAIA,MAAM,SAAS,aAAa,qBAAqB;AAGjD,IAAa,mBAAb,MAA8D;CAC5D,AAAQ;CACR,AAAQ;CACR,AAAQ;CAER,YAAY,QAAqB;AAC/B,OAAK,WAAW,OAAO,YAAY;AACnC,OAAK,eAAe,OAAO,gBAAgB;AAC3C,OAAK,WAAW,OAAO,YAAY;;CAGrC,MAAM,UACJ,IACA,SACY;EACZ,IAAI;AAEJ,OAAK,IAAI,UAAU,GAAG,WAAW,KAAK,UAAU,UAC9C,KAAI;GACF,MAAM,SAAS,MAAM,IAAI;AAEzB,OAAI,UAAU,EACZ,QAAO,OAAO,EAAE,aAAa,EAC3B,gBAAgB,UAAU,GAC3B,CAAC;AAGJ,UAAO;WACA,OAAO;AACd,eAAY;AAGZ,OAAI,YAAY,KAAK,UAAU;AAC7B,WAAO,OAAO,EAAE,aAAa,EAC3B,gBAAgB,UAAU,GAC3B,CAAC;AACF,UAAM;;AAIR,OAAI,QAAQ,QAAQ,QAClB,OAAM;GAGR,MAAM,QAAQ,KAAK,eAAe,QAAQ;AAC1C,SAAM,KAAK,MAAM,MAAM;;AAK3B,QAAM;;CAGR,AAAQ,eAAe,SAAyB;EAE9C,MAAM,QAAQ,KAAK,eAAe,MAAM,UAAU;AAGlD,SAAO,KAAK,IAAI,OAAO,KAAK,SAAS;;CAGvC,AAAQ,MAAM,IAA2B;AACvC,SAAO,IAAI,SAAS,YAAY,WAAW,SAAS,GAAG,CAAC"}

package/dist/plugin/plugin.d.ts

@@ -28,34 +28,20 @@ declare abstract class Plugin<TConfig extends BasePluginConfig = BasePluginConfi
   setup(): Promise<void>;
   getEndpoints(): PluginEndpointMap;
   abortActiveOperations(): void;
+  /**
+   * Returns the public exports for this plugin.
+   * Override this to define a custom public API.
+   * By default, returns an empty object.
+   */
+  exports(): unknown;
   /**
    * Execute operations using the user's identity from the request.
-   *
-   * Returns a scoped instance of this plugin where all method calls
-   * will execute with the user's Databricks credentials instead of
-   * the service principal.
+   * Returns a proxy of this plugin where all method calls execute
+   * with the user's Databricks credentials instead of the service principal.
    *
    * @param req - The Express request containing the user token in headers
-   * @returns A scoped plugin instance that executes as the user
+   * @returns A proxied plugin instance that executes as the user
    * @throws Error if user token is not available in request headers
-   *
-   * @example
-   * ```typescript
-   * // In route handler - execute query as the requesting user
-   * router.post('/users/me/query/:key', async (req, res) => {
-   *   const result = await this.asUser(req).query(req.params.key)
-   *   res.json(result)
-   * })
-   *
-   * // Mixed execution in same handler
-   * router.post('/dashboard', async (req, res) => {
-   *   const [systemData, userData] = await Promise.all([
-   *     this.getSystemStats(),                  // Service principal
-   *     this.asUser(req).getUserPreferences(), // User context
-   *   ])
-   *   res.json({ systemData, userData })
-   * })
-   * ```
    */
   asUser(req: express.Request): this;
   /**
@@ -63,7 +49,7 @@ declare abstract class Plugin<TConfig extends BasePluginConfig = BasePluginConfi
    * This allows all plugin methods to automatically use the user's
    * Databricks credentials.
    */
-  private createUserContextProxy;
+  private _createUserContextProxy;
   protected executeStream<T>(res: IAppResponse, fn: StreamExecuteHandler<T>, options: StreamExecutionSettings, userKey?: string): Promise<void>;
   protected execute<T>(fn: (signal?: AbortSignal) => Promise<T>, options: PluginExecutionSettings, userKey?: string): Promise<T | undefined>;
   protected registerEndpoint(name: string, path: string): void;

package/dist/plugin/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","names":[],"sources":["../../src/plugin/plugin.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;uBA8DsB,uBACJ,mBAAmB,6BACxB;oBAgBmB;EAlBV,UAAM,OAAA,EAAA,OAAA;EAAA,UAAA,KAAA,EAKT,YALS;YACV,GAAA,EAKD,UALC;YAAmB,aAAA,EAMV,aANU;YAiBL,aAAA,EAVL,aAUK;YAbb,SAAA,EAII,UAJJ;qBACF,OAAA,EAAA,MAAA,EAAA;;UAEU,mBAAA;SACJ,KAAA,EAMP,WANO;MAMP,EAAA,MAAA;aAGgB,CAAA,MAAA,EAAA,OAAA;aAeN,CAAA,CAAA,EAAA,IAAA;cAIb,CAAA,CAAA,EAJK,OAAA,CAAQ,MAIb,CAAA,EAAA,IAAA;OAEK,CAAA,CAAA,EAFL,OAEK,CAAA,IAAA,CAAA;cAqCI,CAAA,CAAA,EArCJ,iBAqCI;uBA6Db,CAAA,CAAA,EAAA,IAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA7DK,OAAA,CAAQ;;;;;;;kCA6Db,kBACD,qBAAqB,aAChB,4CACO;qCA2DF,gBAAgB,QAAQ,aAC7B,4CAER,QAAQ;;sCA0BD,OAAA,CAAQ,gBACR"}
+{"version":3,"file":"plugin.d.ts","names":[],"sources":["../../src/plugin/plugin.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;uBA8DsB,uBACJ,mBAAmB,6BACxB;oBAgBmB;EAlBV,UAAM,OAAA,EAAA,OAAA;EAAA,UAAA,KAAA,EAKT,YALS;YACV,GAAA,EAKD,UALC;YAAmB,aAAA,EAMV,aANU;YAiBL,aAAA,EAVL,aAUK;YAbb,SAAA,EAII,UAJJ;qBACF,OAAA,EAAA,MAAA,EAAA;;UAEU,mBAAA;SACJ,KAAA,EAMP,WANO;MAMP,EAAA,MAAA;aAGgB,CAAA,MAAA,EAAA,OAAA;aAeN,CAAA,CAAA,EAAA,IAAA;cAIb,CAAA,CAAA,EAJK,OAAA,CAAQ,MAIb,CAAA,EAAA,IAAA;OAEK,CAAA,CAAA,EAFL,OAEK,CAAA,IAAA,CAAA;cA0BI,CAAA,CAAA,EA1BJ,iBA0BI;uBA6Db,CAAA,CAAA,EAAA,IAAA;;;;;;SA8DiC,CAAA,CAAA,EAAA,OAAA;;;;;;;;;;cA3H5B,OAAA,CAAQ;;;;;;;kCA6Db,kBACD,qBAAqB,aAChB,4CACO;qCA2DF,gBAAgB,QAAQ,aAC7B,4CAER,QAAQ;;sCA0BD,OAAA,CAAQ,gBACR"}