@uipath/uipath-typescript 1.0.0 → 1.1.1

package/dist/core/index.d.ts

@@ -56,6 +56,11 @@ interface IUiPath {
      * Get the current authentication token
      */
     getToken(): string | undefined;
+    /**
+     * Logout from the SDK, clearing all authentication state.
+     * After calling this method, the user will need to re-initialize to authenticate again.
+     */
+    logout(): void;
 }
 
 /**
@@ -116,6 +121,11 @@ declare class UiPath implements IUiPath {
      * Get the current authentication token
      */
     getToken(): string | undefined;
+    /**
+     * Logout from the SDK, clearing all authentication state.
+     * After calling this method, the user will need to re-initialize to authenticate again.
+     */
+    logout(): void;
 }
 
 /**
@@ -187,17 +197,13 @@ interface ErrorParams {
 
 /**
  * Base error class for all UiPath SDK errors
- * Pure TypeScript class with clean interface
+ * Extends Error for standard error handling compatibility
  */
-declare abstract class UiPathError {
+declare abstract class UiPathError extends Error {
     /**
      * Error type identifier (e.g., "AuthenticationError", "ValidationError")
      */
     readonly type: string;
-    /**
-     * Error message describing what went wrong
-     */
-    readonly message: string;
     /**
      * HTTP status code (400, 401, 403, 404, 500, etc.)
      */
@@ -210,10 +216,6 @@ declare abstract class UiPathError {
      * Timestamp when the error occurred
      */
     readonly timestamp: Date;
-    /**
-     * Stack trace for debugging
-     */
-    readonly stack?: string;
     protected constructor(type: string, params: ErrorParams);
     /**
      * Returns a clean JSON representation of the error
@@ -402,5 +404,103 @@ declare const DEFAULT_TOTAL_COUNT_FIELD = "@odata.count";
  */
 declare function getLimitedPageSize(pageSize?: number): number;
 
-export { AuthenticationError, AuthorizationError, DEFAULT_ITEMS_FIELD, DEFAULT_PAGE_SIZE, DEFAULT_TOTAL_COUNT_FIELD, ErrorType, HttpStatus, MAX_PAGE_SIZE, NetworkError, NotFoundError, RateLimitError, ServerError, UiPath, UiPathError, ValidationError, getErrorDetails, getLimitedPageSize, isAuthenticationError, isAuthorizationError, isNetworkError, isNotFoundError, isRateLimitError, isServerError, isUiPathError, isValidationError };
+/**
+ * Telemetry type definitions
+ */
+interface TelemetryAttributes {
+    [key: string]: string | number | boolean;
+}
+interface TelemetryConfig {
+    baseUrl?: string;
+    orgName?: string;
+    tenantName?: string;
+    clientId?: string;
+    redirectUri?: string;
+}
+interface TrackOptions {
+    condition?: boolean | ((...args: any[]) => boolean);
+    attributes?: TelemetryAttributes;
+}
+
+/**
+ * SDK Track decorator and function for telemetry
+ */
+
+/**
+ * Track decorator that can be used to automatically track function calls
+ *
+ * Usage:
+ * @track("Service.Method")
+ * function myFunction() { ... }
+ *
+ * @track("Queue.GetAll")
+ * async getAll() { ... }
+ *
+ * @track("Tasks.Create")
+ * async create() { ... }
+ *
+ * @track("Assets.Update", { condition: false })
+ * function myFunction() { ... }
+ *
+ * @track("Processes.Start", { attributes: { customProp: "value" } })
+ * function myFunction() { ... }
+ */
+declare function track(nameOrOptions?: string | TrackOptions, options?: TrackOptions): MethodDecorator | ((target: any) => any);
+/**
+ * Direct tracking function
+ */
+declare function trackEvent(eventName: string, name?: string, attributes?: TelemetryAttributes): void;
+
+/**
+ * Singleton telemetry client
+ */
+declare class TelemetryClient {
+    private static instance;
+    private isInitialized;
+    private logProvider?;
+    private logger?;
+    private telemetryContext?;
+    private constructor();
+    static getInstance(): TelemetryClient;
+    /**
+     * Initialize telemetry
+     */
+    initialize(config?: TelemetryConfig): void;
+    private getConnectionString;
+    private setupTelemetryProvider;
+    /**
+     * Track a telemetry event
+     */
+    track(eventName: string, name?: string, extraAttributes?: TelemetryAttributes): void;
+    /**
+     * Get enriched attributes for telemetry events
+     */
+    private getEnrichedAttributes;
+    /**
+     * Create cloud URL from base URL, organization ID, and tenant ID
+     */
+    private createCloudUrl;
+}
+declare const telemetryClient: TelemetryClient;
+
+/**
+ * SDK Telemetry constants
+ */
+declare const CONNECTION_STRING = "InstrumentationKey=a6efa11d-1feb-4508-9738-e13e12dcae5e;IngestionEndpoint=https://westeurope-5.in.applicationinsights.azure.com/;LiveEndpoint=https://westeurope.livediagnostics.monitor.azure.com/;ApplicationId=7c58eb1c-9581-4ba6-839e-11725848a037";
+declare const SDK_VERSION = "1.1.1";
+declare const VERSION = "Version";
+declare const SERVICE = "Service";
+declare const CLOUD_ORGANIZATION_NAME = "CloudOrganizationName";
+declare const CLOUD_TENANT_NAME = "CloudTenantName";
+declare const CLOUD_URL = "CloudUrl";
+declare const CLOUD_CLIENT_ID = "CloudClientId";
+declare const CLOUD_REDIRECT_URI = "CloudRedirectUri";
+declare const APP_NAME = "ApplicationName";
+declare const CLOUD_ROLE_NAME = "uipath-ts-sdk";
+declare const SDK_SERVICE_NAME = "UiPath.TypeScript.Sdk";
+declare const SDK_LOGGER_NAME = "uipath-ts-sdk-telemetry";
+declare const SDK_RUN_EVENT = "Sdk.Run";
+declare const UNKNOWN = "";
+
+export { APP_NAME, AuthenticationError, AuthorizationError, CLOUD_CLIENT_ID, CLOUD_ORGANIZATION_NAME, CLOUD_REDIRECT_URI, CLOUD_ROLE_NAME, CLOUD_TENANT_NAME, CLOUD_URL, CONNECTION_STRING, DEFAULT_ITEMS_FIELD, DEFAULT_PAGE_SIZE, DEFAULT_TOTAL_COUNT_FIELD, ErrorType, HttpStatus, MAX_PAGE_SIZE, NetworkError, NotFoundError, RateLimitError, SDK_LOGGER_NAME, SDK_RUN_EVENT, SDK_SERVICE_NAME, SDK_VERSION, SERVICE, ServerError, UNKNOWN, UiPath, UiPathError, VERSION, ValidationError, getErrorDetails, getLimitedPageSize, isAuthenticationError, isAuthorizationError, isNetworkError, isNotFoundError, isRateLimitError, isServerError, isUiPathError, isValidationError, telemetryClient, track, trackEvent };
 export type { HasPaginationOptions, NonPaginatedResponse, PaginatedResponse, PaginationCursor, PaginationMethodUnion, PaginationOptions, UiPathSDKConfig };