@robosystems/client 0.1.11 → 0.1.12

package/extensions/SSEClient.d.js

@@ -0,0 +1,35 @@
+/**
+ * Core SSE (Server-Sent Events) client for RoboSystems API
+ * Provides automatic reconnection, event replay, and type-safe event handling
+ */
+
+
+export declare enum EventType {
+    OPERATION_STARTED = "operation_started",
+    OPERATION_PROGRESS = "operation_progress",
+    OPERATION_COMPLETED = "operation_completed",
+    OPERATION_ERROR = "operation_error",
+    OPERATION_CANCELLED = "operation_cancelled",
+    DATA_CHUNK = "data_chunk",
+    METADATA = "metadata",
+    HEARTBEAT = "heartbeat",
+    QUEUE_UPDATE = "queue_update"
+}
+export declare class SSEClient {
+    private config;
+    private eventSource?;
+    private reconnectAttempts;
+    private lastEventId?;
+    private closed;
+    private listeners;
+    constructor(config);
+    connect(operationId, fromSequence?);
+    private handleMessage;
+    private handleTypedEvent;
+    private handleError;
+    on(event, listener);
+    off(event, listener);
+    private emit;
+    close();
+    isConnected();
+}

package/extensions/SSEClient.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Core SSE (Server-Sent Events) client for RoboSystems API
+ * Provides automatic reconnection, event replay, and type-safe event handling
+ */
+export interface SSEConfig {
+    baseUrl: string;
+    credentials?: 'include' | 'same-origin' | 'omit';
+    headers?: Record<string, string>;
+    maxRetries?: number;
+    retryDelay?: number;
+    heartbeatInterval?: number;
+}
+export interface SSEEvent {
+    event: string;
+    data: any;
+    id?: string;
+    retry?: number;
+    timestamp: Date;
+}
+export declare enum EventType {
+    OPERATION_STARTED = "operation_started",
+    OPERATION_PROGRESS = "operation_progress",
+    OPERATION_COMPLETED = "operation_completed",
+    OPERATION_ERROR = "operation_error",
+    OPERATION_CANCELLED = "operation_cancelled",
+    DATA_CHUNK = "data_chunk",
+    METADATA = "metadata",
+    HEARTBEAT = "heartbeat",
+    QUEUE_UPDATE = "queue_update"
+}
+export declare class SSEClient {
+    private config;
+    private eventSource?;
+    private reconnectAttempts;
+    private lastEventId?;
+    private closed;
+    private listeners;
+    constructor(config: SSEConfig);
+    connect(operationId: string, fromSequence?: number): Promise<void>;
+    private handleMessage;
+    private handleTypedEvent;
+    private handleError;
+    on(event: string, listener: (data: any) => void): void;
+    off(event: string, listener: (data: any) => void): void;
+    private emit;
+    close(): void;
+    isConnected(): boolean;
+}

package/extensions/config.d.js

@@ -0,0 +1,25 @@
+/**
+ * Configuration for SDK extensions
+ * Provides centralized configuration for CORS, credentials, and other settings
+ */
+
+/**
+ * Set global configuration for SDK extensions
+ * @param config Partial configuration to merge with defaults
+ */
+export declare function setSDKExtensionsConfig(config);
+/**
+ * Get current SDK extensions configuration
+ * @returns Current configuration
+ */
+export declare function getSDKExtensionsConfig();
+/**
+ * Reset configuration to defaults
+ */
+export declare function resetSDKExtensionsConfig();
+/**
+ * Get configuration for a specific environment
+ * @param env Environment name (production, staging, development)
+ * @returns Environment-specific configuration
+ */
+export declare function getEnvironmentConfig(env? | 'staging' | 'development');

package/extensions/config.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Configuration for SDK extensions
+ * Provides centralized configuration for CORS, credentials, and other settings
+ */
+export interface SDKExtensionsConfig {
+    baseUrl?: string;
+    credentials?: 'include' | 'same-origin' | 'omit';
+    headers?: Record<string, string>;
+    timeout?: number;
+    maxRetries?: number;
+    retryDelay?: number;
+}
+/**
+ * Set global configuration for SDK extensions
+ * @param config Partial configuration to merge with defaults
+ */
+export declare function setSDKExtensionsConfig(config: Partial<SDKExtensionsConfig>): void;
+/**
+ * Get current SDK extensions configuration
+ * @returns Current configuration
+ */
+export declare function getSDKExtensionsConfig(): SDKExtensionsConfig;
+/**
+ * Reset configuration to defaults
+ */
+export declare function resetSDKExtensionsConfig(): void;
+/**
+ * Get configuration for a specific environment
+ * @param env Environment name (production, staging, development)
+ * @returns Environment-specific configuration
+ */
+export declare function getEnvironmentConfig(env?: 'production' | 'staging' | 'development'): SDKExtensionsConfig;

package/extensions/hooks.d.js

@@ -0,0 +1,80 @@
+import { OperationProgress, OperationResult } from './OperationClient';
+import { OperationClient } from './OperationClient';
+import { QueryOptions, QueryResult } from './QueryClient';
+import { QueryClient } from './QueryClient';
+/**
+ * Hook for executing Cypher queries with loading states and error handling
+ *
+ * @example
+ * ```tsx
+ * const { execute, loading, error, data } = useQuery('graph_123')
+ *
+ * const handleSearch = async () => {
+ *   const result = await execute('MATCH (n:Company) RETURN n LIMIT 10')
+ *   console.log(result.data)
+ * }
+ * ```
+ */
+export declare function useQuery(graphId);
+/**
+ * Hook for streaming large query results
+ *
+ * @example
+ * ```tsx
+ * const { stream, isStreaming, error, cancel } = useStreamingQuery('graph_123')
+ *
+ * const handleStream = async () => {
+ *   const iterator = stream('MATCH (n) RETURN n')
+ *   for await (const batch of iterator) {
+ *     console.log('Received batch:', batch)
+ *   }
+ * }
+ * ```
+ */
+export declare function useStreamingQuery(graphId);
+/**
+ * Hook for monitoring long-running operations
+ *
+ * @example
+ * ```tsx
+ * const { monitor, status, progress, error, result } = useOperation()
+ *
+ * const handleBackup = async () => {
+ *   const { operation_id } = await createBackup({ ... })
+ *   const result = await monitor(operation_id)
+ *   console.log('Backup completed:', result)
+ * }
+ * ```
+ */
+export declare function useOperation(operationId?);
+/**
+ * Hook for monitoring multiple operations concurrently
+ *
+ * @example
+ * ```tsx
+ * const { monitorAll, results, allCompleted, hasErrors } = useMultipleOperations()
+ *
+ * const handleMultiple = async () => {
+ *   const operations = await Promise.all([
+ *     createBackup(...),
+ *     createExport(...),
+ *   ])
+ *
+ *   const results = await monitorAll(operations.map(op => op.operation_id))
+ * }
+ * ```
+ */
+export declare function useMultipleOperations();
+/**
+ * Hook that provides access to all SDK extension clients
+ * Useful when you need direct access to the underlying clients
+ *
+ * @example
+ * ```tsx
+ * const clients = useSDKClients()
+ *
+ * // Direct access to clients
+ * const result = await clients.query.query('graph_123', 'MATCH (n) RETURN n')
+ * ```
+ */
+export declare function useSDKClients();

package/extensions/hooks.d.ts

@@ -0,0 +1,110 @@
+import type { OperationProgress, OperationResult } from './OperationClient';
+import { OperationClient } from './OperationClient';
+import type { QueryOptions, QueryResult } from './QueryClient';
+import { QueryClient } from './QueryClient';
+/**
+ * Hook for executing Cypher queries with loading states and error handling
+ *
+ * @example
+ * ```tsx
+ * const { execute, loading, error, data } = useQuery('graph_123')
+ *
+ * const handleSearch = async () => {
+ *   const result = await execute('MATCH (n:Company) RETURN n LIMIT 10')
+ *   console.log(result.data)
+ * }
+ * ```
+ */
+export declare function useQuery(graphId: string): {
+    execute: (query: string, parameters?: Record<string, any>, options?: QueryOptions) => Promise<QueryResult | null>;
+    query: (cypher: string, parameters?: Record<string, any>) => Promise<any[]>;
+    loading: boolean;
+    error: Error;
+    data: QueryResult;
+    queuePosition: number;
+};
+/**
+ * Hook for streaming large query results
+ *
+ * @example
+ * ```tsx
+ * const { stream, isStreaming, error, cancel } = useStreamingQuery('graph_123')
+ *
+ * const handleStream = async () => {
+ *   const iterator = stream('MATCH (n) RETURN n')
+ *   for await (const batch of iterator) {
+ *     console.log('Received batch:', batch)
+ *   }
+ * }
+ * ```
+ */
+export declare function useStreamingQuery(graphId: string): {
+    stream: (query: string, parameters?: Record<string, any>, chunkSize?: number) => AsyncIterableIterator<any[]>;
+    isStreaming: boolean;
+    error: Error;
+    rowsReceived: number;
+    cancel: () => void;
+};
+/**
+ * Hook for monitoring long-running operations
+ *
+ * @example
+ * ```tsx
+ * const { monitor, status, progress, error, result } = useOperation<BackupResult>()
+ *
+ * const handleBackup = async () => {
+ *   const { operation_id } = await createBackup({ ... })
+ *   const result = await monitor(operation_id)
+ *   console.log('Backup completed:', result)
+ * }
+ * ```
+ */
+export declare function useOperation<T = any>(operationId?: string): {
+    monitor: (id: string, timeout?: number) => Promise<OperationResult<T> | null>;
+    cancel: (id: string) => Promise<void>;
+    status: "error" | "idle" | "running" | "completed";
+    progress: OperationProgress;
+    error: Error;
+    result: OperationResult<T>;
+};
+/**
+ * Hook for monitoring multiple operations concurrently
+ *
+ * @example
+ * ```tsx
+ * const { monitorAll, results, allCompleted, hasErrors } = useMultipleOperations()
+ *
+ * const handleMultiple = async () => {
+ *   const operations = await Promise.all([
+ *     createBackup(...),
+ *     createExport(...),
+ *   ])
+ *
+ *   const results = await monitorAll(operations.map(op => op.operation_id))
+ * }
+ * ```
+ */
+export declare function useMultipleOperations<T = any>(): {
+    monitorAll: (operationIds: string[]) => Promise<Map<string, OperationResult<T>>>;
+    results: Map<string, OperationResult<T>>;
+    errors: Map<string, Error>;
+    loading: boolean;
+    allCompleted: boolean;
+    hasErrors: boolean;
+};
+/**
+ * Hook that provides access to all SDK extension clients
+ * Useful when you need direct access to the underlying clients
+ *
+ * @example
+ * ```tsx
+ * const clients = useSDKClients()
+ *
+ * // Direct access to clients
+ * const result = await clients.query.query('graph_123', 'MATCH (n) RETURN n')
+ * ```
+ */
+export declare function useSDKClients(): {
+    query: QueryClient | null;
+    operations: OperationClient | null;
+};

package/extensions/hooks.js

@@ -31,7 +31,7 @@ export function useQuery(graphId) {
   const [error, setError] = useState(null)
   const [data, setData] = useState(null)
   const [queuePosition, setQueuePosition] = useState(null)
-  const clientRef = useRef()
+  const clientRef = useRef(null)
 
   // Initialize client
   useEffect(() => {
@@ -128,7 +128,7 @@ export function useStreamingQuery(graphId) {
   const [isStreaming, setIsStreaming] = useState(false)
   const [error, setError] = useState(null)
   const [rowsReceived, setRowsReceived] = useState(0)
-  const clientRef = useRef()
+  const clientRef = useRef(null)
 
   useEffect(() => {
     const sdkConfig = getSDKExtensionsConfig()
@@ -221,7 +221,7 @@ export function useOperation(operationId?) {
   const [progress, setProgress] = useState(null)
   const [error, setError] = useState(null)
   const [result, setResult] = useState | null>(null)
-  const clientRef = useRef()
+  const clientRef = useRef(null)
 
   useEffect(() => {
     const sdkConfig = getSDKExtensionsConfig()
@@ -329,7 +329,7 @@ export function useMultipleOperations() {
   const [results, setResults] = useState>>(new Map())
   const [loading, setLoading] = useState(false)
   const [errors, setErrors] = useState>(new Map())
-  const clientRef = useRef()
+  const clientRef = useRef(null)
 
   useEffect(() => {
     const sdkConfig = getSDKExtensionsConfig()

package/extensions/hooks.ts

@@ -31,7 +31,7 @@ export function useQuery(graphId: string) {
   const [error, setError] = useState<Error | null>(null)
   const [data, setData] = useState<QueryResult | null>(null)
   const [queuePosition, setQueuePosition] = useState<number | null>(null)
-  const clientRef = useRef<QueryClient>()
+  const clientRef = useRef<QueryClient>(null)
 
   // Initialize client
   useEffect(() => {
@@ -128,7 +128,7 @@ export function useStreamingQuery(graphId: string) {
   const [isStreaming, setIsStreaming] = useState(false)
   const [error, setError] = useState<Error | null>(null)
   const [rowsReceived, setRowsReceived] = useState(0)
-  const clientRef = useRef<QueryClient>()
+  const clientRef = useRef<QueryClient>(null)
 
   useEffect(() => {
     const sdkConfig = getSDKExtensionsConfig()
@@ -221,7 +221,7 @@ export function useOperation<T = any>(operationId?: string) {
   const [progress, setProgress] = useState<OperationProgress | null>(null)
   const [error, setError] = useState<Error | null>(null)
   const [result, setResult] = useState<OperationResult<T> | null>(null)
-  const clientRef = useRef<OperationClient>()
+  const clientRef = useRef<OperationClient>(null)
 
   useEffect(() => {
     const sdkConfig = getSDKExtensionsConfig()
@@ -329,7 +329,7 @@ export function useMultipleOperations<T = any>() {
   const [results, setResults] = useState<Map<string, OperationResult<T>>>(new Map())
   const [loading, setLoading] = useState(false)
   const [errors, setErrors] = useState<Map<string, Error>>(new Map())
-  const clientRef = useRef<OperationClient>()
+  const clientRef = useRef<OperationClient>(null)
 
   useEffect(() => {
     const sdkConfig = getSDKExtensionsConfig()

package/extensions/index.d.js

@@ -0,0 +1,35 @@
+/**
+ * RoboSystems SDK Extensions
+ * Enhanced clients with SSE support for the RoboSystems API
+ */
+import { OperationClient } from './OperationClient';
+import { QueryClient } from './QueryClient';
+import { SSEClient } from './SSEClient';
+
+export declare class RoboSystemsExtensions {
+    readonly query;
+    readonly operations;
+    private config;
+    constructor(config?);
+    /**
+     * Convenience method to monitor any operation
+     */
+    monitorOperation(operationId, onProgress?);
+    /**
+     * Create custom SSE client for advanced use cases
+     */
+    createSSEClient();
+    /**
+     * Clean up all active connections
+     */
+    close();
+}
+export * from './OperationClient';
+export * from './QueryClient';
+export * from './SSEClient';
+export { OperationClient, QueryClient, SSEClient };
+export { useMultipleOperations, useOperation, useQuery, useSDKClients, useStreamingQuery, } from './hooks';
+export declare const extensions;
+export declare const monitorOperation) => Promise;
+export declare const executeQuery;
+export declare const streamQuery;

package/extensions/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * RoboSystems SDK Extensions
+ * Enhanced clients with SSE support for the RoboSystems API
+ */
+import { OperationClient } from './OperationClient';
+import { QueryClient } from './QueryClient';
+import { SSEClient } from './SSEClient';
+export interface RoboSystemsExtensionConfig {
+    baseUrl?: string;
+    credentials?: 'include' | 'same-origin' | 'omit';
+    maxRetries?: number;
+    retryDelay?: number;
+}
+export declare class RoboSystemsExtensions {
+    readonly query: QueryClient;
+    readonly operations: OperationClient;
+    private config;
+    constructor(config?: RoboSystemsExtensionConfig);
+    /**
+     * Convenience method to monitor any operation
+     */
+    monitorOperation(operationId: string, onProgress?: (progress: any) => void): Promise<any>;
+    /**
+     * Create custom SSE client for advanced use cases
+     */
+    createSSEClient(): SSEClient;
+    /**
+     * Clean up all active connections
+     */
+    close(): void;
+}
+export * from './OperationClient';
+export * from './QueryClient';
+export * from './SSEClient';
+export { OperationClient, QueryClient, SSEClient };
+export { useMultipleOperations, useOperation, useQuery, useSDKClients, useStreamingQuery, } from './hooks';
+export declare const extensions: {
+    readonly query: QueryClient;
+    readonly operations: OperationClient;
+    monitorOperation: (operationId: string, onProgress?: (progress: any) => void) => Promise<any>;
+    createSSEClient: () => SSEClient;
+    close: () => void;
+};
+export declare const monitorOperation: (operationId: string, onProgress?: (progress: any) => void) => Promise<any>;
+export declare const executeQuery: (graphId: string, query: string, parameters?: Record<string, any>) => Promise<import("./QueryClient").QueryResult>;
+export declare const streamQuery: (graphId: string, query: string, parameters?: Record<string, any>, chunkSize?: number) => AsyncIterableIterator<any>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robosystems/client",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "TypeScript client library for RoboSystems Financial Knowledge Graph API",
   "main": "index.js",
   "types": "index.d.ts",
@@ -52,13 +52,13 @@
     "url": "https://github.com/RoboFinSystems/robosystems-typescript-client/issues"
   },
   "homepage": "https://github.com/RoboFinSystems/robosystems-typescript-client#readme",
-  "dependencies": {},
   "engines": {
     "node": ">=18.0.0"
   },
   "devDependencies": {
     "@hey-api/openapi-ts": "^0.80.2",
     "@types/node": "^22.0.0",
+    "@types/react": "^19.1.9",
     "@typescript-eslint/eslint-plugin": "^7.0.0",
     "@typescript-eslint/parser": "^7.0.0",
     "eslint": "^8.0.0",

package/prepare.js

@@ -11,6 +11,16 @@ const { execSync } = require('child_process')
 
 console.log('🚀 Preparing RoboSystems SDK for publishing...')
 
+// First, build the TypeScript
+console.log('🔨 Building TypeScript...')
+try {
+  execSync('npm run build', { stdio: 'inherit' })
+  console.log('✅ TypeScript build complete')
+} catch (error) {
+  console.error('❌ TypeScript build failed:', error.message)
+  process.exit(1)
+}
+
 const sdkSourceDir = path.join(__dirname, 'sdk')
 const currentDir = __dirname