@semiont/api-client 0.2.1 → 0.2.2

package/dist/sse/index.js

@@ -1,404 +0,0 @@
-"use strict";
-/**
- * SSE Client for Semiont Streaming Endpoints
- *
- * Provides type-safe methods for Server-Sent Events streaming.
- * Does NOT use ky - uses native fetch() for SSE support.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SSEClient = void 0;
-const stream_1 = require("./stream");
-/**
- * SSE Client for real-time streaming operations
- *
- * Separate from the main HTTP client to clearly mark streaming endpoints.
- * Uses native fetch() instead of ky for SSE support.
- *
- * @example
- * ```typescript
- * const sseClient = new SSEClient({
- *   baseUrl: 'http://localhost:4000',
- *   accessToken: 'your-token'
- * });
- *
- * const stream = sseClient.detectAnnotations(
- *   'http://localhost:4000/resources/doc-123',
- *   { entityTypes: ['Person', 'Organization'] }
- * );
- *
- * stream.onProgress((p) => console.log(p.message));
- * stream.onComplete((r) => console.log(`Found ${r.foundCount} entities`));
- * stream.onError((e) => console.error('Detection failed:', e));
- * ```
- */
-class SSEClient {
-    baseUrl;
-    accessToken = null;
-    constructor(config) {
-        // Remove trailing slash for consistent URL construction
-        this.baseUrl = (config.baseUrl.endsWith('/') ? config.baseUrl.slice(0, -1) : config.baseUrl);
-        this.accessToken = config.accessToken || null;
-    }
-    /**
-     * Set the access token for authenticated requests
-     */
-    setAccessToken(token) {
-        this.accessToken = token;
-    }
-    /**
-     * Clear the access token
-     */
-    clearAccessToken() {
-        this.accessToken = null;
-    }
-    /**
-     * Get common headers for SSE requests
-     */
-    getHeaders() {
-        const headers = {
-            'Content-Type': 'application/json'
-        };
-        if (this.accessToken) {
-            headers['Authorization'] = `Bearer ${this.accessToken}`;
-        }
-        return headers;
-    }
-    /**
-     * Extract resource ID from URI
-     *
-     * Handles both full URIs and plain IDs:
-     * - 'http://localhost:4000/resources/doc-123' -> 'doc-123'
-     * - 'doc-123' -> 'doc-123'
-     */
-    extractId(uri) {
-        const parts = uri.split('/');
-        return parts[parts.length - 1];
-    }
-    /**
-     * Detect annotations in a resource (streaming)
-     *
-     * Streams entity detection progress via Server-Sent Events.
-     *
-     * @param resourceId - Resource URI or ID
-     * @param request - Detection configuration (entity types to detect)
-     * @returns SSE stream controller with progress/complete/error callbacks
-     *
-     * @example
-     * ```typescript
-     * const stream = sseClient.detectAnnotations(
-     *   'http://localhost:4000/resources/doc-123',
-     *   { entityTypes: ['Person', 'Organization'] }
-     * );
-     *
-     * stream.onProgress((progress) => {
-     *   console.log(`Scanning: ${progress.currentEntityType}`);
-     *   console.log(`Progress: ${progress.processedEntityTypes}/${progress.totalEntityTypes}`);
-     * });
-     *
-     * stream.onComplete((result) => {
-     *   console.log(`Detection complete! Found ${result.foundCount} entities`);
-     * });
-     *
-     * stream.onError((error) => {
-     *   console.error('Detection failed:', error.message);
-     * });
-     *
-     * // Cleanup when done
-     * stream.close();
-     * ```
-     */
-    detectAnnotations(resourceId, request) {
-        const id = this.extractId(resourceId);
-        const url = `${this.baseUrl}/resources/${id}/detect-annotations-stream`;
-        return (0, stream_1.createSSEStream)(url, {
-            method: 'POST',
-            headers: this.getHeaders(),
-            body: JSON.stringify(request)
-        }, {
-            progressEvents: ['detection-started', 'detection-progress'],
-            completeEvent: 'detection-complete',
-            errorEvent: 'detection-error'
-        });
-    }
-    /**
-     * Generate resource from annotation (streaming)
-     *
-     * Streams resource generation progress via Server-Sent Events.
-     *
-     * @param resourceId - Source resource URI or ID
-     * @param annotationId - Annotation URI or ID to use as generation source
-     * @param request - Generation options (title, prompt, language)
-     * @returns SSE stream controller with progress/complete/error callbacks
-     *
-     * @example
-     * ```typescript
-     * const stream = sseClient.generateResourceFromAnnotation(
-     *   'http://localhost:4000/resources/doc-123',
-     *   'http://localhost:4000/annotations/ann-456',
-     *   { language: 'es', title: 'Spanish Summary' }
-     * );
-     *
-     * stream.onProgress((progress) => {
-     *   console.log(`${progress.status}: ${progress.percentage}%`);
-     *   console.log(progress.message);
-     * });
-     *
-     * stream.onComplete((result) => {
-     *   console.log(`Generated resource: ${result.resourceId}`);
-     * });
-     *
-     * stream.onError((error) => {
-     *   console.error('Generation failed:', error.message);
-     * });
-     *
-     * // Cleanup when done
-     * stream.close();
-     * ```
-     */
-    generateResourceFromAnnotation(resourceId, annotationId, request) {
-        const resId = this.extractId(resourceId);
-        const annId = this.extractId(annotationId);
-        const url = `${this.baseUrl}/resources/${resId}/annotations/${annId}/generate-resource-stream`;
-        return (0, stream_1.createSSEStream)(url, {
-            method: 'POST',
-            headers: this.getHeaders(),
-            body: JSON.stringify(request)
-        }, {
-            progressEvents: ['generation-started', 'generation-progress'],
-            completeEvent: 'generation-complete',
-            errorEvent: 'generation-error'
-        });
-    }
-    /**
-     * Detect highlights in a resource (streaming)
-     *
-     * Streams highlight detection progress via Server-Sent Events.
-     *
-     * @param resourceId - Resource URI or ID
-     * @param request - Detection configuration (optional instructions)
-     * @returns SSE stream controller with progress/complete/error callbacks
-     *
-     * @example
-     * ```typescript
-     * const stream = sseClient.detectHighlights(
-     *   'http://localhost:4000/resources/doc-123',
-     *   { instructions: 'Focus on key technical points' }
-     * );
-     *
-     * stream.onProgress((progress) => {
-     *   console.log(`${progress.status}: ${progress.percentage}%`);
-     *   console.log(progress.message);
-     * });
-     *
-     * stream.onComplete((result) => {
-     *   console.log(`Detection complete! Created ${result.createdCount} highlights`);
-     * });
-     *
-     * stream.onError((error) => {
-     *   console.error('Detection failed:', error.message);
-     * });
-     *
-     * // Cleanup when done
-     * stream.close();
-     * ```
-     */
-    detectHighlights(resourceId, request = {}) {
-        const id = this.extractId(resourceId);
-        const url = `${this.baseUrl}/resources/${id}/detect-highlights-stream`;
-        return (0, stream_1.createSSEStream)(url, {
-            method: 'POST',
-            headers: this.getHeaders(),
-            body: JSON.stringify(request)
-        }, {
-            progressEvents: ['highlight-detection-started', 'highlight-detection-progress'],
-            completeEvent: 'highlight-detection-complete',
-            errorEvent: 'highlight-detection-error'
-        });
-    }
-    /**
-     * Detect assessments in a resource (streaming)
-     *
-     * Streams assessment detection progress via Server-Sent Events.
-     *
-     * @param resourceId - Resource URI or ID
-     * @param request - Detection configuration (optional instructions)
-     * @returns SSE stream controller with progress/complete/error callbacks
-     *
-     * @example
-     * ```typescript
-     * const stream = sseClient.detectAssessments(
-     *   'http://localhost:4000/resources/doc-123',
-     *   { instructions: 'Evaluate claims for accuracy' }
-     * );
-     *
-     * stream.onProgress((progress) => {
-     *   console.log(`${progress.status}: ${progress.percentage}%`);
-     *   console.log(progress.message);
-     * });
-     *
-     * stream.onComplete((result) => {
-     *   console.log(`Detection complete! Created ${result.createdCount} assessments`);
-     * });
-     *
-     * stream.onError((error) => {
-     *   console.error('Detection failed:', error.message);
-     * });
-     *
-     * // Cleanup when done
-     * stream.close();
-     * ```
-     */
-    detectAssessments(resourceId, request = {}) {
-        const id = this.extractId(resourceId);
-        const url = `${this.baseUrl}/resources/${id}/detect-assessments-stream`;
-        return (0, stream_1.createSSEStream)(url, {
-            method: 'POST',
-            headers: this.getHeaders(),
-            body: JSON.stringify(request)
-        }, {
-            progressEvents: ['assessment-detection-started', 'assessment-detection-progress'],
-            completeEvent: 'assessment-detection-complete',
-            errorEvent: 'assessment-detection-error'
-        });
-    }
-    /**
-     * Detect comments in a resource (streaming)
-     *
-     * Streams comment detection progress via Server-Sent Events.
-     * Uses AI to identify passages that would benefit from explanatory comments
-     * and creates comment annotations with contextual information.
-     *
-     * @param resourceId - Resource URI or ID
-     * @param request - Detection configuration (optional instructions and tone)
-     * @returns SSE stream controller with progress/complete/error callbacks
-     *
-     * @example
-     * ```typescript
-     * const stream = sseClient.detectComments('http://localhost:4000/resources/doc-123', {
-     *   instructions: 'Focus on technical terminology',
-     *   tone: 'scholarly'
-     * });
-     *
-     * stream.onProgress((progress) => {
-     *   console.log(`${progress.status}: ${progress.percentage}%`);
-     * });
-     *
-     * stream.onComplete((result) => {
-     *   console.log(`Detection complete! Created ${result.createdCount} comments`);
-     * });
-     *
-     * stream.onError((error) => {
-     *   console.error('Detection failed:', error.message);
-     * });
-     *
-     * // Cleanup when done
-     * stream.close();
-     * ```
-     */
-    detectComments(resourceId, request = {}) {
-        const id = this.extractId(resourceId);
-        const url = `${this.baseUrl}/resources/${id}/detect-comments-stream`;
-        return (0, stream_1.createSSEStream)(url, {
-            method: 'POST',
-            headers: this.getHeaders(),
-            body: JSON.stringify(request)
-        }, {
-            progressEvents: ['comment-detection-started', 'comment-detection-progress'],
-            completeEvent: 'comment-detection-complete',
-            errorEvent: 'comment-detection-error'
-        });
-    }
-    /**
-     * Detect tags in a resource (streaming)
-     *
-     * Streams tag detection progress via Server-Sent Events.
-     * Uses AI to identify passages serving specific structural roles
-     * (e.g., IRAC, IMRAD, Toulmin) and creates tag annotations with dual-body structure.
-     *
-     * @param resourceId - Resource URI or ID
-     * @param request - Detection configuration (schema and categories to detect)
-     * @returns SSE stream controller with progress/complete/error callbacks
-     *
-     * @example
-     * ```typescript
-     * const stream = sseClient.detectTags('http://localhost:4000/resources/doc-123', {
-     *   schemaId: 'legal-irac',
-     *   categories: ['Issue', 'Rule', 'Application', 'Conclusion']
-     * });
-     *
-     * stream.onProgress((progress) => {
-     *   console.log(`${progress.status}: ${progress.percentage}%`);
-     *   console.log(`Processing ${progress.currentCategory}...`);
-     * });
-     *
-     * stream.onComplete((result) => {
-     *   console.log(`Detection complete! Created ${result.tagsCreated} tags`);
-     * });
-     *
-     * stream.onError((error) => {
-     *   console.error('Detection failed:', error.message);
-     * });
-     *
-     * // Cleanup when done
-     * stream.close();
-     * ```
-     */
-    detectTags(resourceId, request) {
-        const id = this.extractId(resourceId);
-        const url = `${this.baseUrl}/resources/${id}/detect-tags-stream`;
-        return (0, stream_1.createSSEStream)(url, {
-            method: 'POST',
-            headers: this.getHeaders(),
-            body: JSON.stringify(request)
-        }, {
-            progressEvents: ['tag-detection-started', 'tag-detection-progress'],
-            completeEvent: 'tag-detection-complete',
-            errorEvent: 'tag-detection-error'
-        });
-    }
-    /**
-     * Subscribe to resource events (long-lived stream)
-     *
-     * Opens a long-lived SSE connection to receive real-time events for a resource.
-     * Used for collaborative editing - see events from other users as they happen.
-     *
-     * This stream does NOT have a complete event - it stays open until explicitly closed.
-     *
-     * @param resourceId - Resource URI or ID to subscribe to
-     * @returns SSE stream controller with event callback
-     *
-     * @example
-     * ```typescript
-     * const stream = sseClient.resourceEvents('http://localhost:4000/resources/doc-123');
-     *
-     * stream.onProgress((event) => {
-     *   console.log(`Event: ${event.type}`);
-     *   console.log(`User: ${event.userId}`);
-     *   console.log(`Sequence: ${event.metadata.sequenceNumber}`);
-     *   console.log(`Payload:`, event.payload);
-     * });
-     *
-     * stream.onError((error) => {
-     *   console.error('Stream error:', error.message);
-     * });
-     *
-     * // Close when no longer needed (e.g., component unmount)
-     * stream.close();
-     * ```
-     */
-    resourceEvents(resourceId) {
-        const id = this.extractId(resourceId);
-        const url = `${this.baseUrl}/resources/${id}/events/stream`;
-        return (0, stream_1.createSSEStream)(url, {
-            method: 'GET',
-            headers: this.getHeaders()
-        }, {
-            progressEvents: ['*'], // Accept all event types
-            completeEvent: null, // Long-lived stream - no completion
-            errorEvent: 'error', // Generic error event
-            customEventHandler: true // Use custom event handling
-        });
-    }
-}
-exports.SSEClient = SSEClient;
-//# sourceMappingURL=index.js.map

package/dist/sse/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sse/index.ts"],"names":[],"mappings":"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"}

package/dist/sse/stream.d.ts

@@ -1,58 +0,0 @@
-/**
- * SSE Stream Factory
- *
- * Creates Server-Sent Events streams using native fetch() and manual parsing.
- * Does NOT use the EventSource API for better control over connection lifecycle.
- */
-import type { SSEStream } from './types';
-/**
- * Configuration for SSE stream event handling
- */
-interface SSEConfig {
-    /** Event types that trigger onProgress callback */
-    progressEvents: string[];
-    /** Event type that triggers onComplete callback (null for long-lived streams) */
-    completeEvent: string | null;
-    /** Event type that triggers onError callback */
-    errorEvent: string | null;
-    /** If true, use custom event handlers instead of standard mapping */
-    customEventHandler?: boolean;
-}
-/**
- * Create an SSE stream with typed event callbacks
- *
- * Uses native fetch() with manual SSE parsing for fine-grained control.
- * Supports AbortController for cancellation.
- *
- * @typeParam TProgress - Type of progress event data
- * @typeParam TComplete - Type of completion event data
- *
- * @param url - Full URL to SSE endpoint
- * @param fetchOptions - fetch() options (method, headers, body)
- * @param config - Event mapping configuration
- * @returns SSEStream controller with callback registration and cleanup
- *
- * @example
- * ```typescript
- * const stream = createSSEStream<DetectionProgress, DetectionProgress>(
- *   'http://localhost:4000/resources/123/detect-annotations-stream',
- *   {
- *     method: 'POST',
- *     headers: { 'Authorization': 'Bearer token', 'Content-Type': 'application/json' },
- *     body: JSON.stringify({ entityTypes: ['Person'] })
- *   },
- *   {
- *     progressEvents: ['detection-started', 'detection-progress'],
- *     completeEvent: 'detection-complete',
- *     errorEvent: 'detection-error'
- *   }
- * );
- *
- * stream.onProgress((p) => console.log(p.message));
- * stream.onComplete((r) => console.log('Done!'));
- * stream.close(); // Cleanup
- * ```
- */
-export declare function createSSEStream<TProgress, TComplete>(url: string, fetchOptions: RequestInit, config: SSEConfig): SSEStream<TProgress, TComplete>;
-export {};
-//# sourceMappingURL=stream.d.ts.map

package/dist/sse/stream.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/sse/stream.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;GAEG;AACH,UAAU,SAAS;IACjB,mDAAmD;IACnD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,iFAAiF;IACjF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gDAAgD;IAChD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,EAClD,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,WAAW,EACzB,MAAM,EAAE,SAAS,GAChB,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,CA4JjC"}

package/dist/sse/stream.js

@@ -1,187 +0,0 @@
-"use strict";
-/**
- * SSE Stream Factory
- *
- * Creates Server-Sent Events streams using native fetch() and manual parsing.
- * Does NOT use the EventSource API for better control over connection lifecycle.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createSSEStream = createSSEStream;
-/**
- * Create an SSE stream with typed event callbacks
- *
- * Uses native fetch() with manual SSE parsing for fine-grained control.
- * Supports AbortController for cancellation.
- *
- * @typeParam TProgress - Type of progress event data
- * @typeParam TComplete - Type of completion event data
- *
- * @param url - Full URL to SSE endpoint
- * @param fetchOptions - fetch() options (method, headers, body)
- * @param config - Event mapping configuration
- * @returns SSEStream controller with callback registration and cleanup
- *
- * @example
- * ```typescript
- * const stream = createSSEStream<DetectionProgress, DetectionProgress>(
- *   'http://localhost:4000/resources/123/detect-annotations-stream',
- *   {
- *     method: 'POST',
- *     headers: { 'Authorization': 'Bearer token', 'Content-Type': 'application/json' },
- *     body: JSON.stringify({ entityTypes: ['Person'] })
- *   },
- *   {
- *     progressEvents: ['detection-started', 'detection-progress'],
- *     completeEvent: 'detection-complete',
- *     errorEvent: 'detection-error'
- *   }
- * );
- *
- * stream.onProgress((p) => console.log(p.message));
- * stream.onComplete((r) => console.log('Done!'));
- * stream.close(); // Cleanup
- * ```
- */
-function createSSEStream(url, fetchOptions, config) {
-    const abortController = new AbortController();
-    let progressCallback = null;
-    let completeCallback = null;
-    let errorCallback = null;
-    const customHandlers = new Map();
-    let closed = false; // Flag to stop processing events after close/complete/error
-    /**
-     * Start the SSE connection and parse the stream
-     */
-    const connect = async () => {
-        try {
-            const response = await fetch(url, {
-                ...fetchOptions,
-                signal: abortController.signal,
-                headers: {
-                    ...fetchOptions.headers,
-                    'Accept': 'text/event-stream'
-                }
-            });
-            if (!response.ok) {
-                const errorData = await response.json().catch(() => ({}));
-                throw new Error(errorData.message || `HTTP ${response.status}: ${response.statusText}`);
-            }
-            if (!response.body) {
-                throw new Error('Response body is null - server did not return a stream');
-            }
-            // Parse SSE stream
-            const reader = response.body.getReader();
-            const decoder = new TextDecoder();
-            let buffer = '';
-            // Event state persists across reads to handle multi-chunk events
-            let eventType = '';
-            let eventData = '';
-            let eventId = '';
-            while (true) {
-                const { done, value } = await reader.read();
-                if (done || closed)
-                    break;
-                buffer += decoder.decode(value, { stream: true });
-                const lines = buffer.split('\n');
-                // Keep the last partial line in the buffer
-                buffer = lines.pop() || '';
-                for (const line of lines) {
-                    if (line.startsWith('event:')) {
-                        eventType = line.slice(6).trim();
-                    }
-                    else if (line.startsWith('data:')) {
-                        eventData = line.slice(5).trim();
-                    }
-                    else if (line.startsWith('id:')) {
-                        eventId = line.slice(3).trim();
-                    }
-                    else if (line === '') {
-                        // Empty line marks end of event
-                        if (eventData && !closed) {
-                            handleEvent(eventType, eventData, eventId);
-                            if (closed)
-                                break; // Stop processing if event triggered close
-                            eventType = '';
-                            eventData = '';
-                            eventId = '';
-                        }
-                    }
-                }
-                if (closed)
-                    break; // Exit outer loop if closed
-            }
-        }
-        catch (error) {
-            // Don't report AbortError (normal cleanup)
-            if (error instanceof Error && error.name !== 'AbortError') {
-                errorCallback?.(error);
-            }
-        }
-    };
-    /**
-     * Handle a parsed SSE event
-     */
-    const handleEvent = (eventType, data, _id) => {
-        // Skip keep-alive comments
-        if (data.startsWith(':')) {
-            return;
-        }
-        try {
-            const parsed = JSON.parse(data);
-            // Custom event handler (for resourceEvents which handles all events)
-            if (config.customEventHandler) {
-                const handler = customHandlers.get(eventType);
-                if (handler) {
-                    handler(parsed);
-                    return;
-                }
-                // Pass all events to progress handler if no specific handler
-                progressCallback?.(parsed);
-                return;
-            }
-            // Progress events
-            if (config.progressEvents.includes(eventType)) {
-                progressCallback?.(parsed);
-            }
-            // Complete event
-            if (config.completeEvent && eventType === config.completeEvent) {
-                completeCallback?.(parsed);
-                closed = true; // Stop processing further events
-                abortController.abort(); // Close stream on completion
-            }
-            // Error event
-            if (config.errorEvent && eventType === config.errorEvent) {
-                errorCallback?.(new Error(parsed.message || 'Stream error'));
-                closed = true; // Stop processing further events
-                abortController.abort(); // Close stream on error
-            }
-        }
-        catch (error) {
-            console.error('[SSE] Failed to parse event data:', error);
-            console.error('[SSE] Event type:', eventType);
-            console.error('[SSE] Data:', data);
-        }
-    };
-    // Start connection immediately
-    connect();
-    // Return SSE stream controller
-    return {
-        onProgress(callback) {
-            progressCallback = callback;
-        },
-        onComplete(callback) {
-            completeCallback = callback;
-        },
-        onError(callback) {
-            errorCallback = callback;
-        },
-        close() {
-            abortController.abort();
-        },
-        // Internal method for custom event handlers (used by resourceEvents)
-        on(event, callback) {
-            customHandlers.set(event, callback);
-        }
-    };
-}
-//# sourceMappingURL=stream.js.map

package/dist/sse/stream.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/sse/stream.ts"],"names":[],"mappings":"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"}