@databricks/appkit 0.1.4 → 0.2.0

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

@@ -0,0 +1,108 @@
+import { SeverityNumber, logs } from "@opentelemetry/api-logs";
+
+//#region src/logging/wide-event-emitter.ts
+/**
+* Emits WideEvents to OpenTelemetry as structured logs
+*/
+var WideEventEmitter = class {
+	constructor() {
+		this.logger = logs.getLogger("appkit", "1.0.0");
+	}
+	/**
+	* Emit a WideEvent to OpenTelemetry.
+	* Fails silently to avoid crashing the application due to observability issues.
+	*/
+	emit(event) {
+		try {
+			const logRecord = {
+				timestamp: Date.parse(event.timestamp),
+				severityNumber: this.getSeverityNumber(event),
+				severityText: this.getSeverityText(event),
+				body: this.createLogBody(event),
+				attributes: this.createAttributes(event)
+			};
+			this.logger.emit(logRecord);
+		} catch {}
+	}
+	/**
+	* Get OpenTelemetry severity number based on event data
+	*/
+	getSeverityNumber(event) {
+		if (event.error) return SeverityNumber.ERROR;
+		if (event.status_code) {
+			if (event.status_code >= 500) return SeverityNumber.ERROR;
+			if (event.status_code >= 400) return SeverityNumber.WARN;
+		}
+		if (event.logs) {
+			if (event.logs.some((log) => log.level === "error")) return SeverityNumber.ERROR;
+			if (event.logs.some((log) => log.level === "warn")) return SeverityNumber.WARN;
+		}
+		return SeverityNumber.INFO;
+	}
+	/**
+	* Get severity text based on severity number
+	*/
+	getSeverityText(event) {
+		const severityNumber = this.getSeverityNumber(event);
+		if (severityNumber >= SeverityNumber.ERROR) return "ERROR";
+		if (severityNumber >= SeverityNumber.WARN) return "WARN";
+		if (severityNumber >= SeverityNumber.INFO) return "INFO";
+		return "DEBUG";
+	}
+	/**
+	* Create log body from event data
+	*/
+	createLogBody(event) {
+		const parts = [];
+		if (event.method && event.path) parts.push(`${event.method} ${event.path}`);
+		if (event.status_code) parts.push(`→ ${event.status_code}`);
+		if (event.duration_ms) parts.push(`(${event.duration_ms}ms)`);
+		if (event.component) {
+			const componentStr = event.component.operation ? `${event.component.name}.${event.component.operation}` : event.component.name;
+			parts.push(`[${componentStr}]`);
+		}
+		if (event.error) parts.push(`ERROR: ${event.error.message}`);
+		return parts.join(" ");
+	}
+	/**
+	* Create OpenTelemetry attributes from event data
+	*/
+	createAttributes(event) {
+		const attributes = {
+			request_id: event.request_id,
+			trace_id: event.trace_id,
+			"http.method": event.method,
+			"http.route": event.path,
+			"http.status_code": event.status_code,
+			"http.request.duration_ms": event.duration_ms,
+			"service.name": event.service?.name,
+			"service.version": event.service?.version,
+			"service.region": event.service?.region,
+			"service.deployment_id": event.service?.deployment_id,
+			"service.node_env": event.service?.node_env,
+			"component.name": event.component?.name,
+			"component.operation": event.component?.operation,
+			"user.id": event.user?.id,
+			"error.type": event.error?.type,
+			"error.code": event.error?.code,
+			"error.message": event.error?.message,
+			"error.retriable": event.error?.retriable,
+			"execution.timeout_ms": event.execution?.timeout_ms,
+			"execution.retry_attempts": event.execution?.retry_attempts,
+			"execution.cache_hit": event.execution?.cache_hit,
+			"execution.cache_key": event.execution?.cache_key,
+			"execution.cache_deduplication": event.execution?.cache_deduplication,
+			"stream.id": event.stream?.stream_id,
+			"stream.events_sent": event.stream?.events_sent,
+			log_count: event.logs?.length
+		};
+		if (event.context) {
+			for (const [scope, scopeData] of Object.entries(event.context)) for (const [key, value] of Object.entries(scopeData)) if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") attributes[`${scope}.${key}`] = value;
+		}
+		return Object.fromEntries(Object.entries(attributes).filter(([_, value]) => value !== void 0));
+	}
+};
+
+//#endregion
+export { WideEventEmitter };
+//# sourceMappingURL=wide-event-emitter.js.map

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

@@ -0,0 +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"}

package/dist/logging/wide-event.js

@@ -0,0 +1,167 @@
+//#region src/logging/wide-event.ts
+/**
+* WideEvent
+* - Represents a single event for a request
+* - Fields are camelCase to match OpenTelemetry
+*/
+var WideEvent = class {
+	constructor(requestId) {
+		this.startTime = Date.now();
+		this.data = {
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			request_id: requestId,
+			service: {
+				name: "appkit",
+				version: process.env.npm_package_version || "unknown",
+				region: process.env.REGION,
+				deployment_id: process.env.DEPLOYMENT_ID,
+				node_env: process.env.NODE_ENV
+			},
+			logs: [],
+			context: {}
+		};
+	}
+	/**
+	* Set a value in the event
+	* @param key - The key to set
+	* @param value - The value to set
+	* @returns The event
+	*/
+	set(key, value) {
+		if (typeof value === "object" && value !== null && !Array.isArray(value)) this.data[key] = {
+			...this.data[key],
+			...value
+		};
+		else this.data[key] = value;
+		return this;
+	}
+	/**
+	* Set the component name and operation.
+	* Component can be a plugin, connector, or service.
+	* @param name - The name of the component (e.g., "analytics", "sql-warehouse", "cache-manager")
+	* @param operation - The operation being performed (e.g., "query", "getOrExecute")
+	* @returns The event
+	*/
+	setComponent(name, operation) {
+		this.data.component = {
+			name,
+			operation
+		};
+		return this;
+	}
+	/**
+	* Set the user context
+	* @param user - The user context
+	* @returns The event
+	*/
+	setUser(user) {
+		this.data.user = {
+			...this.data.user,
+			...user
+		};
+		return this;
+	}
+	/**
+	* Set the execution context
+	* @param execution - The execution context
+	* @returns The event
+	*/
+	setExecution(execution) {
+		this.data.execution = {
+			...this.data.execution,
+			...execution
+		};
+		return this;
+	}
+	/**
+	* Set the stream context
+	* @param stream - The stream context
+	* @returns The event
+	*/
+	setStream(stream) {
+		this.data.stream = {
+			...this.data.stream,
+			...stream
+		};
+		return this;
+	}
+	/**
+	* Set the error context
+	* @param error - The error context
+	* @returns The event
+	*/
+	setError(error) {
+		const isAppKitError = "code" in error && "statusCode" in error;
+		const errorCause = error.cause;
+		this.data.error = {
+			type: error.name,
+			code: isAppKitError ? error.code : "UNKNOWN_ERROR",
+			message: error.message,
+			retriable: isAppKitError ? error.isRetryable : false,
+			cause: errorCause ? String(errorCause) : void 0
+		};
+		return this;
+	}
+	/**
+	* Add scoped context to the event
+	* @param scope - The scope name (plugin, connector, or service name)
+	* @param ctx - Context data to merge
+	* @example
+	* event.setContext("analytics", { query_key: "apps_list", rows_returned: 100 });
+	* event.setContext("sql-warehouse", { warehouse_id: "1234567890" });
+	*/
+	setContext(scope, ctx) {
+		if (!this.data.context) this.data.context = {};
+		this.data.context[scope] = {
+			...this.data.context[scope],
+			...ctx
+		};
+		return this;
+	}
+	/**
+	* Add a log to the event
+	* @param level - The level of the log
+	* @param message - The message of the log
+	* @param context - The context of the log
+	* @returns The event
+	*/
+	addLog(level, message, context) {
+		if (!this.data.logs) this.data.logs = [];
+		this.data.logs.push({
+			level,
+			message,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			context
+		});
+		if (this.data.logs.length > 50) this.data.logs = this.data.logs.slice(-50);
+		return this;
+	}
+	/**
+	* Finalize the event
+	* @param statusCode - The status code of the response
+	* @returns The event data
+	*/
+	finalize(statusCode) {
+		this.data.status_code = statusCode;
+		this.data.duration_ms = this.getDurationMs();
+		return this.data;
+	}
+	/**
+	* Get the duration of the event in milliseconds
+	* @returns The duration of the event in milliseconds
+	*/
+	getDurationMs() {
+		return this.data.duration_ms || Date.now() - this.startTime;
+	}
+	/**
+	* Convert the event to a JSON object
+	* @returns The event data as a JSON object
+	*/
+	toJSON() {
+		return this.data;
+	}
+};
+
+//#endregion
+export { WideEvent };
+//# sourceMappingURL=wide-event.js.map

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

@@ -0,0 +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"}

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":";;;;KAIK,sBAAA,SAAsB,QAAA,CACF,YACpB;;;AAL0C;;AAGpB,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"}

package/dist/plugin/dev-reader.js

@@ -1,7 +1,12 @@
+import { createLogger } from "../logging/logger.js";
+import { TunnelError } from "../errors/tunnel.js";
+import { init_errors } from "../errors/index.js";
 import { isRemoteTunnelAllowedByEnv } from "../server/remote-tunnel/gate.js";
 import { randomUUID } from "node:crypto";
 
 //#region src/plugin/dev-reader.ts
+init_errors();
+const logger = createLogger("plugin:dev-reader");
 /**
 * This class is used to read files from the local filesystem in dev mode
 * through the WebSocket tunnel.
@@ -19,7 +24,7 @@ var DevFileReader = class DevFileReader {
 				if (isRemoteTunnelAllowedByEnv()) return Reflect.get(target, prop, receiver);
 				const value = Reflect.get(target, prop, receiver);
 				if (typeof value === "function") return function noop() {
-					console.info(`Noop: ${String(prop)} (remote server disabled)`);
+					logger.debug("Noop: %s (remote server disabled)", String(prop));
 					return Promise.resolve("");
 				};
 				return value;
@@ -34,9 +39,9 @@ var DevFileReader = class DevFileReader {
 		this.getTunnelForRequest = getter;
 	}
 	async readFile(filePath, req) {
-		if (!this.getTunnelForRequest) throw new Error("Tunnel getter not registered for DevFileReader singleton");
+		if (!this.getTunnelForRequest) throw TunnelError.getterNotRegistered();
 		const tunnel = this.getTunnelForRequest(req);
-		if (!tunnel) throw new Error("No tunnel connection available for file read");
+		if (!tunnel) throw TunnelError.noConnection();
 		const { ws, pendingFileReads } = tunnel;
 		const requestId = randomUUID();
 		return new Promise((resolve, reject) => {

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\";\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              console.info(`Noop: ${String(prop)} (remote server disabled)`);\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 new Error(\n        \"Tunnel getter not registered for DevFileReader singleton\",\n      );\n    }\n    const tunnel = this.getTunnelForRequest(req);\n\n    if (!tunnel) {\n      throw new Error(\"No tunnel connection available for file read\");\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":";;;;;;;;AAYA,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,aAAQ,KAAK,SAAS,OAAO,KAAK,CAAC,2BAA2B;AAC9D,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,IAAI,MACR,2DACD;EAEH,MAAM,SAAS,KAAK,oBAAoB,IAAI;AAE5C,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,+CAA+C;EAGjE,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"],"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"cache.js","names":["cacheManager: CacheManager","config: CacheConfig"],"sources":["../../../src/plugin/interceptors/cache.ts"],"sourcesContent":["import type { CacheManager } from \"../../cache\";\nimport type { CacheConfig } from \"shared\";\nimport type { ExecutionContext, ExecutionInterceptor } from \"./types\";\n\n// interceptor to handle caching logic\nexport class CacheInterceptor implements ExecutionInterceptor {\n  constructor(\n    private cacheManager: CacheManager,\n    private config: CacheConfig,\n  ) {}\n\n  async intercept<T>(\n    fn: () => Promise<T>,\n    context: ExecutionContext,\n  ): Promise<T> {\n    // if cache disabled, ignore\n    if (!this.config.enabled || !this.config.cacheKey?.length) {\n      return fn();\n    }\n\n    return this.cacheManager.getOrExecute(\n      this.config.cacheKey,\n      fn,\n      context.userKey,\n      { ttl: this.config.ttl },\n    );\n  }\n}\n"],"mappings":";AAKA,IAAa,mBAAb,MAA8D;CAC5D,YACE,AAAQA,cACR,AAAQC,QACR;EAFQ;EACA;;CAGV,MAAM,UACJ,IACA,SACY;AAEZ,MAAI,CAAC,KAAK,OAAO,WAAW,CAAC,KAAK,OAAO,UAAU,OACjD,QAAO,IAAI;AAGb,SAAO,KAAK,aAAa,aACvB,KAAK,OAAO,UACZ,IACA,QAAQ,SACR,EAAE,KAAK,KAAK,OAAO,KAAK,CACzB"}
+{"version":3,"file":"cache.js","names":[],"sources":["../../../src/plugin/interceptors/cache.ts"],"sourcesContent":["import type { CacheConfig } from \"shared\";\nimport type { CacheManager } from \"../../cache\";\nimport type { ExecutionInterceptor, InterceptorContext } from \"./types\";\n\n// interceptor to handle caching logic\nexport class CacheInterceptor implements ExecutionInterceptor {\n  constructor(\n    private cacheManager: CacheManager,\n    private config: CacheConfig,\n  ) {}\n\n  async intercept<T>(\n    fn: () => Promise<T>,\n    context: InterceptorContext,\n  ): Promise<T> {\n    // if cache disabled, ignore\n    if (!this.config.enabled || !this.config.cacheKey?.length) {\n      return fn();\n    }\n\n    return this.cacheManager.getOrExecute(\n      this.config.cacheKey,\n      fn,\n      context.userKey,\n      { ttl: this.config.ttl },\n    );\n  }\n}\n"],"mappings":";AAKA,IAAa,mBAAb,MAA8D;CAC5D,YACE,AAAQ,cACR,AAAQ,QACR;EAFQ;EACA;;CAGV,MAAM,UACJ,IACA,SACY;AAEZ,MAAI,CAAC,KAAK,OAAO,WAAW,CAAC,KAAK,OAAO,UAAU,OACjD,QAAO,IAAI;AAGb,SAAO,KAAK,aAAa,aACvB,KAAK,OAAO,UACZ,IACA,QAAQ,SACR,EAAE,KAAK,KAAK,OAAO,KAAK,CACzB"}

package/dist/plugin/interceptors/retry.js

@@ -1,4 +1,7 @@
+import { createLogger } from "../../logging/logger.js";
+
 //#region src/plugin/interceptors/retry.ts
+const logger = createLogger("interceptors:retry");
 var RetryInterceptor = class {
 	constructor(config) {
 		this.attempts = config.attempts ?? 3;
@@ -8,10 +11,15 @@ var RetryInterceptor = class {
 	async intercept(fn, context) {
 		let lastError;
 		for (let attempt = 1; attempt <= this.attempts; attempt++) try {
-			return await fn();
+			const result = await fn();
+			if (attempt > 1) logger.event()?.setExecution({ retry_attempts: attempt - 1 });
+			return result;
 		} catch (error) {
 			lastError = error;
-			if (attempt === this.attempts) throw error;
+			if (attempt === this.attempts) {
+				logger.event()?.setExecution({ retry_attempts: attempt - 1 });
+				throw error;
+			}
 			if (context.signal?.aborted) throw error;
 			const delay = this.calculateDelay(attempt);
 			await this.sleep(delay);

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

@@ -1 +1 @@
-{"version":3,"file":"retry.js","names":["lastError: Error | unknown"],"sources":["../../../src/plugin/interceptors/retry.ts"],"sourcesContent":["import type { RetryConfig } from \"shared\";\nimport type { ExecutionContext, ExecutionInterceptor } from \"./types\";\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: ExecutionContext,\n  ): Promise<T> {\n    let lastError: Error | unknown;\n\n    for (let attempt = 1; attempt <= this.attempts; attempt++) {\n      try {\n        return await fn();\n      } catch (error) {\n        lastError = error;\n\n        // last attempt, rethrow the error\n        if (attempt === this.attempts) {\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,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,IAAIA;AAEJ,OAAK,IAAI,UAAU,GAAG,WAAW,KAAK,UAAU,UAC9C,KAAI;AACF,UAAO,MAAM,IAAI;WACV,OAAO;AACd,eAAY;AAGZ,OAAI,YAAY,KAAK,SACnB,OAAM;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;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"}

package/dist/plugin/interceptors/telemetry.js

@@ -1,28 +1,43 @@
 import { SpanStatusCode } from "../../telemetry/index.js";
 
 //#region src/plugin/interceptors/telemetry.ts
-/**
-* Interceptor to automatically instrument plugin executions with telemetry spans.
-* Wraps the execution in a span and handles success/error status.
-*/
 var TelemetryInterceptor = class {
 	constructor(telemetry, config) {
 		this.telemetry = telemetry;
 		this.config = config;
 	}
-	async intercept(fn, _context) {
+	async intercept(fn, context) {
 		const spanName = this.config?.spanName || "plugin.execute";
+		if (context.signal?.aborted) throw new Error("Operation aborted before execution");
 		return this.telemetry.startActiveSpan(spanName, { attributes: this.config?.attributes }, async (span) => {
+			let abortHandler;
+			let isAborted = false;
+			if (context.signal) {
+				abortHandler = () => {
+					if (!span.isRecording()) return;
+					isAborted = true;
+					span.setAttribute("cancelled", true);
+					span.setStatus({
+						code: SpanStatusCode.ERROR,
+						message: "Operation cancelled by client"
+					});
+					span.end();
+				};
+				context.signal.addEventListener("abort", abortHandler, { once: true });
+			}
 			try {
 				const result = await fn();
-				span.setStatus({ code: SpanStatusCode.OK });
+				if (!isAborted) span.setStatus({ code: SpanStatusCode.OK });
 				return result;
 			} catch (error) {
-				span.recordException(error);
-				span.setStatus({ code: SpanStatusCode.ERROR });
+				if (!isAborted) {
+					span.recordException(error);
+					span.setStatus({ code: SpanStatusCode.ERROR });
+				}
 				throw error;
 			} finally {
-				span.end();
+				if (abortHandler && context.signal) context.signal.removeEventListener("abort", abortHandler);
+				if (!isAborted) span.end();
 			}
 		});
 	}

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

@@ -1 +1 @@
-{"version":3,"file":"telemetry.js","names":["telemetry: ITelemetry","config?: TelemetryConfig"],"sources":["../../../src/plugin/interceptors/telemetry.ts"],"sourcesContent":["import type { ITelemetry, Span } from \"../../telemetry\";\nimport { SpanStatusCode } from \"../../telemetry\";\nimport type { TelemetryConfig } from \"shared\";\nimport type { ExecutionContext, ExecutionInterceptor } from \"./types\";\n\n/**\n * Interceptor to automatically instrument plugin executions with telemetry spans.\n * Wraps the execution in a span and handles success/error status.\n */\nexport class TelemetryInterceptor implements ExecutionInterceptor {\n  constructor(\n    private telemetry: ITelemetry,\n    private config?: TelemetryConfig,\n  ) {}\n\n  async intercept<T>(\n    fn: () => Promise<T>,\n    _context: ExecutionContext,\n  ): Promise<T> {\n    const spanName = this.config?.spanName || \"plugin.execute\";\n    return this.telemetry.startActiveSpan(\n      spanName,\n      { attributes: this.config?.attributes },\n      async (span: Span) => {\n        try {\n          const result = await fn();\n          span.setStatus({ code: SpanStatusCode.OK });\n          return result;\n        } catch (error) {\n          span.recordException(error as Error);\n          span.setStatus({ code: SpanStatusCode.ERROR });\n          throw error;\n        } finally {\n          span.end();\n        }\n      },\n    );\n  }\n}\n"],"mappings":";;;;;;;AASA,IAAa,uBAAb,MAAkE;CAChE,YACE,AAAQA,WACR,AAAQC,QACR;EAFQ;EACA;;CAGV,MAAM,UACJ,IACA,UACY;EACZ,MAAM,WAAW,KAAK,QAAQ,YAAY;AAC1C,SAAO,KAAK,UAAU,gBACpB,UACA,EAAE,YAAY,KAAK,QAAQ,YAAY,EACvC,OAAO,SAAe;AACpB,OAAI;IACF,MAAM,SAAS,MAAM,IAAI;AACzB,SAAK,UAAU,EAAE,MAAM,eAAe,IAAI,CAAC;AAC3C,WAAO;YACA,OAAO;AACd,SAAK,gBAAgB,MAAe;AACpC,SAAK,UAAU,EAAE,MAAM,eAAe,OAAO,CAAC;AAC9C,UAAM;aACE;AACR,SAAK,KAAK;;IAGf"}
+{"version":3,"file":"telemetry.js","names":[],"sources":["../../../src/plugin/interceptors/telemetry.ts"],"sourcesContent":["import type { TelemetryConfig } from \"shared\";\nimport type { ITelemetry, Span } from \"../../telemetry\";\nimport { SpanStatusCode } from \"../../telemetry\";\nimport type { ExecutionInterceptor, InterceptorContext } from \"./types\";\n\nexport class TelemetryInterceptor implements ExecutionInterceptor {\n  constructor(\n    private telemetry: ITelemetry,\n    private config?: TelemetryConfig,\n  ) {}\n\n  async intercept<T>(\n    fn: () => Promise<T>,\n    context: InterceptorContext,\n  ): Promise<T> {\n    const spanName = this.config?.spanName || \"plugin.execute\";\n\n    // abort operation if signal is aborted\n    if (context.signal?.aborted) {\n      throw new Error(\"Operation aborted before execution\");\n    }\n\n    return this.telemetry.startActiveSpan(\n      spanName,\n      { attributes: this.config?.attributes },\n      async (span: Span) => {\n        let abortHandler: (() => void) | undefined;\n        let isAborted = false;\n\n        if (context.signal) {\n          abortHandler = () => {\n            // abort span if not recording\n            if (!span.isRecording()) return;\n            isAborted = true;\n            span.setAttribute(\"cancelled\", true);\n            span.setStatus({\n              code: SpanStatusCode.ERROR,\n              message: \"Operation cancelled by client\",\n            });\n            span.end();\n          };\n          context.signal.addEventListener(\"abort\", abortHandler, {\n            once: true,\n          });\n        }\n\n        try {\n          const result = await fn();\n          if (!isAborted) {\n            span.setStatus({ code: SpanStatusCode.OK });\n          }\n          return result;\n        } catch (error) {\n          if (!isAborted) {\n            span.recordException(error as Error);\n            span.setStatus({ code: SpanStatusCode.ERROR });\n          }\n          throw error;\n        } finally {\n          if (abortHandler && context.signal) {\n            context.signal.removeEventListener(\"abort\", abortHandler);\n          }\n          if (!isAborted) {\n            span.end();\n          }\n        }\n      },\n    );\n  }\n}\n"],"mappings":";;;AAKA,IAAa,uBAAb,MAAkE;CAChE,YACE,AAAQ,WACR,AAAQ,QACR;EAFQ;EACA;;CAGV,MAAM,UACJ,IACA,SACY;EACZ,MAAM,WAAW,KAAK,QAAQ,YAAY;AAG1C,MAAI,QAAQ,QAAQ,QAClB,OAAM,IAAI,MAAM,qCAAqC;AAGvD,SAAO,KAAK,UAAU,gBACpB,UACA,EAAE,YAAY,KAAK,QAAQ,YAAY,EACvC,OAAO,SAAe;GACpB,IAAI;GACJ,IAAI,YAAY;AAEhB,OAAI,QAAQ,QAAQ;AAClB,yBAAqB;AAEnB,SAAI,CAAC,KAAK,aAAa,CAAE;AACzB,iBAAY;AACZ,UAAK,aAAa,aAAa,KAAK;AACpC,UAAK,UAAU;MACb,MAAM,eAAe;MACrB,SAAS;MACV,CAAC;AACF,UAAK,KAAK;;AAEZ,YAAQ,OAAO,iBAAiB,SAAS,cAAc,EACrD,MAAM,MACP,CAAC;;AAGJ,OAAI;IACF,MAAM,SAAS,MAAM,IAAI;AACzB,QAAI,CAAC,UACH,MAAK,UAAU,EAAE,MAAM,eAAe,IAAI,CAAC;AAE7C,WAAO;YACA,OAAO;AACd,QAAI,CAAC,WAAW;AACd,UAAK,gBAAgB,MAAe;AACpC,UAAK,UAAU,EAAE,MAAM,eAAe,OAAO,CAAC;;AAEhD,UAAM;aACE;AACR,QAAI,gBAAgB,QAAQ,OAC1B,SAAQ,OAAO,oBAAoB,SAAS,aAAa;AAE3D,QAAI,CAAC,UACH,MAAK,KAAK;;IAIjB"}

package/dist/plugin/interceptors/timeout.js

@@ -1,9 +1,13 @@
+import { createLogger } from "../../logging/logger.js";
+
 //#region src/plugin/interceptors/timeout.ts
+const logger = createLogger("interceptors:timeout");
 var TimeoutInterceptor = class {
 	constructor(timeoutMs) {
 		this.timeoutMs = timeoutMs;
 	}
 	async intercept(fn, context) {
+		logger.event()?.setExecution({ timeout_ms: this.timeoutMs });
 		const timeoutController = new AbortController();
 		const timeoutId = setTimeout(() => {
 			timeoutController.abort(/* @__PURE__ */ new Error(`Operation timed out after ${this.timeoutMs} ms`));

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

@@ -1 +1 @@
-{"version":3,"file":"timeout.js","names":["timeoutMs: number"],"sources":["../../../src/plugin/interceptors/timeout.ts"],"sourcesContent":["import type { ExecutionContext, ExecutionInterceptor } from \"./types\";\n\n// interceptor to handle timeout logic\nexport class TimeoutInterceptor implements ExecutionInterceptor {\n  constructor(private timeoutMs: number) {}\n\n  async intercept<T>(\n    fn: () => Promise<T>,\n    context: ExecutionContext,\n  ): Promise<T> {\n    // create timeout signal\n    const timeoutController = new AbortController();\n    const timeoutId = setTimeout(() => {\n      timeoutController.abort(\n        new Error(`Operation timed out after ${this.timeoutMs} ms`),\n      );\n    }, this.timeoutMs);\n\n    try {\n      // combine user signal (if exists) with timeout signal\n      const combinedSignal = context.signal\n        ? this._combineSignals([context.signal, timeoutController.signal])\n        : timeoutController.signal;\n\n      // execute function with combined signal\n      context.signal = combinedSignal;\n      return await fn();\n    } finally {\n      // cleanup timeout\n      clearTimeout(timeoutId);\n    }\n  }\n\n  private _combineSignals(signals: AbortSignal[]): AbortSignal {\n    const controller = new AbortController();\n    for (const signal of signals) {\n      if (signal.aborted) {\n        controller.abort(signal.reason);\n        break;\n      }\n      signal.addEventListener(\n        \"abort\",\n        () => {\n          controller.abort(signal.reason);\n        },\n        { once: true },\n      );\n    }\n    return controller.signal;\n  }\n}\n"],"mappings":";AAGA,IAAa,qBAAb,MAAgE;CAC9D,YAAY,AAAQA,WAAmB;EAAnB;;CAEpB,MAAM,UACJ,IACA,SACY;EAEZ,MAAM,oBAAoB,IAAI,iBAAiB;EAC/C,MAAM,YAAY,iBAAiB;AACjC,qBAAkB,sBAChB,IAAI,MAAM,6BAA6B,KAAK,UAAU,KAAK,CAC5D;KACA,KAAK,UAAU;AAElB,MAAI;AAOF,WAAQ,SALe,QAAQ,SAC3B,KAAK,gBAAgB,CAAC,QAAQ,QAAQ,kBAAkB,OAAO,CAAC,GAChE,kBAAkB;AAItB,UAAO,MAAM,IAAI;YACT;AAER,gBAAa,UAAU;;;CAI3B,AAAQ,gBAAgB,SAAqC;EAC3D,MAAM,aAAa,IAAI,iBAAiB;AACxC,OAAK,MAAM,UAAU,SAAS;AAC5B,OAAI,OAAO,SAAS;AAClB,eAAW,MAAM,OAAO,OAAO;AAC/B;;AAEF,UAAO,iBACL,eACM;AACJ,eAAW,MAAM,OAAO,OAAO;MAEjC,EAAE,MAAM,MAAM,CACf;;AAEH,SAAO,WAAW"}
+{"version":3,"file":"timeout.js","names":[],"sources":["../../../src/plugin/interceptors/timeout.ts"],"sourcesContent":["import { createLogger } from \"../../logging/logger\";\nimport type { ExecutionInterceptor, InterceptorContext } from \"./types\";\n\nconst logger = createLogger(\"interceptors:timeout\");\n\n// interceptor to handle timeout logic\nexport class TimeoutInterceptor implements ExecutionInterceptor {\n  constructor(private timeoutMs: number) {}\n\n  async intercept<T>(\n    fn: () => Promise<T>,\n    context: InterceptorContext,\n  ): Promise<T> {\n    logger.event()?.setExecution({\n      timeout_ms: this.timeoutMs,\n    });\n\n    // create timeout signal\n    const timeoutController = new AbortController();\n    const timeoutId = setTimeout(() => {\n      timeoutController.abort(\n        new Error(`Operation timed out after ${this.timeoutMs} ms`),\n      );\n    }, this.timeoutMs);\n\n    try {\n      // combine user signal (if exists) with timeout signal\n      const combinedSignal = context.signal\n        ? this._combineSignals([context.signal, timeoutController.signal])\n        : timeoutController.signal;\n\n      // execute function with combined signal\n      context.signal = combinedSignal;\n      return await fn();\n    } finally {\n      // cleanup timeout\n      clearTimeout(timeoutId);\n    }\n  }\n\n  private _combineSignals(signals: AbortSignal[]): AbortSignal {\n    const controller = new AbortController();\n    for (const signal of signals) {\n      if (signal.aborted) {\n        controller.abort(signal.reason);\n        break;\n      }\n      signal.addEventListener(\n        \"abort\",\n        () => {\n          controller.abort(signal.reason);\n        },\n        { once: true },\n      );\n    }\n    return controller.signal;\n  }\n}\n"],"mappings":";;;AAGA,MAAM,SAAS,aAAa,uBAAuB;AAGnD,IAAa,qBAAb,MAAgE;CAC9D,YAAY,AAAQ,WAAmB;EAAnB;;CAEpB,MAAM,UACJ,IACA,SACY;AACZ,SAAO,OAAO,EAAE,aAAa,EAC3B,YAAY,KAAK,WAClB,CAAC;EAGF,MAAM,oBAAoB,IAAI,iBAAiB;EAC/C,MAAM,YAAY,iBAAiB;AACjC,qBAAkB,sBAChB,IAAI,MAAM,6BAA6B,KAAK,UAAU,KAAK,CAC5D;KACA,KAAK,UAAU;AAElB,MAAI;AAOF,WAAQ,SALe,QAAQ,SAC3B,KAAK,gBAAgB,CAAC,QAAQ,QAAQ,kBAAkB,OAAO,CAAC,GAChE,kBAAkB;AAItB,UAAO,MAAM,IAAI;YACT;AAER,gBAAa,UAAU;;;CAI3B,AAAQ,gBAAgB,SAAqC;EAC3D,MAAM,aAAa,IAAI,iBAAiB;AACxC,OAAK,MAAM,UAAU,SAAS;AAC5B,OAAI,OAAO,SAAS;AAClB,eAAW,MAAM,OAAO,OAAO;AAC/B;;AAEF,UAAO,iBACL,eACM;AACJ,eAAW,MAAM,OAAO,OAAO;MAEjC,EAAE,MAAM,MAAM,CACf;;AAEH,SAAO,WAAW"}

package/dist/plugin/plugin.d.ts

@@ -17,8 +17,6 @@ declare abstract class Plugin<TConfig extends BasePluginConfig = BasePluginConfi
   protected streamManager: StreamManager;
   protected telemetry: ITelemetry;
   protected abstract envVars: string[];
-  /** If the plugin requires the Databricks client to be set in the request context */
-  requiresDatabricksClient: boolean;
   /** Registered endpoints for this plugin */
   private registeredEndpoints;
   static phase: PluginPhase;
@@ -29,8 +27,44 @@ declare abstract class Plugin<TConfig extends BasePluginConfig = BasePluginConfi
   setup(): Promise<void>;
   getEndpoints(): PluginEndpointMap;
   abortActiveOperations(): void;
-  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>;
+  /**
+   * 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.
+   *
+   * @param req - The Express request containing the user token in headers
+   * @returns A scoped 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;
+  /**
+   * Creates a proxy that wraps method calls in a user context.
+   * This allows all plugin methods to automatically use the user's
+   * Databricks credentials.
+   */
+  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;
   protected route<_TResponse>(router: express.Router, config: RouteConfig): void;
   private _buildExecutionConfig;

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

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","names":[],"sources":["../../src/plugin/plugin.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;uBAgCsB,uBACJ,mBAAmB,6BACxB;oBAmBmB;;EArBV,UAAM,KAAA,EAKT,YALS;EAAA,UAAA,GAAA,EAMX,UANW;YACV,aAAA,EAMS,aANT;YAAmB,aAAA,EAOV,aAPU;YAoBL,SAAA,EAZT,UAYS;qBAhBb,OAAA,EAAA,MAAA,EAAA;;0BAEQ,EAAA,OAAA;;UAEJ,mBAAA;SASP,KAAA,EAAA,WAAA;MAGgB,EAAA,MAAA;aAeN,CAAA,MAAA,EAfM,OAeN;aAIb,CAAA,CAAA,EAAA,IAAA;cAEK,CAAA,CAAA,EANA,OAAA,CAAQ,MAMR,CAAA,EAAA,IAAA;OAUT,CAAA,CAAA,EAZI,OAYJ,CAAA,IAAA,CAAA;cACoB,CAAA,CAAA,EAXX,iBAWW;uBAArB,CAAA,CAAA,EAAA,IAAA;YACK,aAAA,CAAA,CAAA,CAAA,CAAA,GAAA,EAFJ,YAEI,EAAA,EAAA,EADL,oBACK,CADgB,CAChB,CAAA,EAAA,OAAA,EAAA,uBAAA,EAAA,OAAA,EAAA,MAAA,CAAA,EACM,OADN,CAAA,IAAA,CAAA;YACM,OAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,MAAA,CAAA,EAwDD,WAxDC,EAAA,GAwDe,OAxDf,CAwDuB,CAxDvB,CAAA,EAAA,OAAA,EAyDN,uBAzDM,EAAA,OAAA,EAAA,MAAA,CAAA,EA2Dd,OA3Dc,CA2DN,CA3DM,GAAA,SAAA,CAAA;YAwDD,gBAAA,CAAA,IAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,CAAA,EAAA,IAAA;YAAwB,KAAA,CAAA,UAAA,CAAA,CAAA,MAAA,EA0B9B,OAAA,CAAQ,MA1BsB,EAAA,MAAA,EA2B9B,WA3B8B,CAAA,EAAA,IAAA;UAAR,qBAAA;UACrB,kBAAA;UAEA,wBAAA;UAAR,iBAAA"}
+{"version":3,"file":"plugin.d.ts","names":[],"sources":["../../src/plugin/plugin.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;uBA6DsB,uBACJ,mBAAmB,6BACxB;oBAgBmB;;EAlBV,UAAM,KAAA,EAKT,YALS;EAAA,UAAA,GAAA,EAMX,UANW;YACV,aAAA,EAMS,aANT;YAAmB,aAAA,EAOV,aAPU;YAiBL,SAAA,EATT,UASS;qBAbb,OAAA,EAAA,MAAA,EAAA;;UAEQ,mBAAA;SACA,KAAA,EAOX,WAPW;MACJ,EAAA,MAAA;aAMP,CAAA,MAAA,EAGgB,OAHhB;aAGgB,CAAA,CAAA,EAAA,IAAA;cAeN,CAAA,CAAA,EAAR,OAAA,CAAQ,MAAA,CAAA,EAAA,IAAA;OAIb,CAAA,CAAA,EAAA,OAAA,CAAA,IAAA,CAAA;cAEK,CAAA,CAAA,EAAA,iBAAA;uBAqCI,CAAA,CAAA,EAAA,IAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAAR,OAAA,CAAQ;;;;;;;kCA6Db,kBACD,qBAAqB,aAChB,4CACO;qCA2DF,gBAAgB,QAAQ,aAC7B,4CAER,QAAQ;;sCA0BD,OAAA,CAAQ,gBACR"}