@semiont/api-client 0.2.34-build.88 → 0.2.34-build.90

package/README.md

@@ -8,6 +8,8 @@
 
 TypeScript SDK for [Semiont](https://github.com/The-AI-Alliance/semiont) - a knowledge management system for semantic annotations, AI-powered annotation detection, and collaborative document analysis.
 
+This package provides the HTTP client, SSE streams, and utilities for working with the Semiont API. OpenAPI types are re-exported from [`@semiont/core`](../core/README.md) (the source of truth).
+
 ## What is Semiont?
 
 Semiont lets you:
@@ -110,12 +112,14 @@ const client = new SemiontApiClient({
 
 ## Key Features
 
-- **Type-safe** - Generated from OpenAPI spec with branded types
+- **Type-safe** - Re-exports OpenAPI types from `@semiont/core` with branded types
 - **W3C compliant** - Web Annotation standard with fuzzy text matching
 - **Real-time** - SSE streaming for long operations
 - **Framework-agnostic** - Pure TypeScript utilities work everywhere
 - **Character encoding** - Proper UTF-8, ISO-8859-1, Windows-1252 support
 
+**Note**: OpenAPI types are generated in `@semiont/core` (source of truth) and re-exported here for convenience.
+
 ## Use Cases
 
 - ✅ MCP servers and AI integrations

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-import { B as BaseUrl, R as ResourceUri, E as EntityType, A as AccessToken, a as AnnotationUri, c as components, b as Email, p as paths, d as RefreshToken, G as GoogleCredential, C as ContentFormat, S as SearchQuery, e as CloneToken, f as ResourceAnnotationUri, M as Motivation, U as UserDID, J as JobId } from './index-CJqmerJr.js';
-export { $ as $defs, aD as AuthCode, al as BoundingBox, F as FragmentSelector, aA as JWTTokenSchema, a1 as LOCALES, a0 as LocaleInfo, aE as MCPToken, W as MatchQuality, ak as Point, i as Selector, h as SvgSelector, V as TextPosition, T as TextPositionSelector, g as TextQuoteSelector, at as ValidatedAnnotation, ay as ValidationFailure, az as ValidationResult, ax as ValidationSuccess, aI as accessToken, aS as annotationUri, aG as authCode, aQ as baseUrl, aL as cloneToken, ao as createCircleSvg, an as createPolygonSvg, am as createRectangleSvg, aj as decodeRepresentation, aw as decodeWithCharset, aF as email, aO as entityType, Q as extractBoundingBox, av as extractCharset, as as extractContext, Y as findBestTextMatch, Z as findTextWithContext, a5 as formatLocaleDisplay, a6 as getAllLocaleCodes, H as getAnnotationExactText, j as getBodySource, k as getBodyType, aa as getChecksum, x as getCommentText, ad as getCreator, ae as getDerivedFrom, D as getExactText, O as getFragmentSelector, ab as getLanguage, a4 as getLocaleEnglishName, a2 as getLocaleInfo, a3 as getLocaleNativeName, ai as getNodeEncoding, a9 as getPrimaryMediaType, a8 as getPrimaryRepresentation, I as getPrimarySelector, ag as getResourceEntityTypes, a7 as getResourceId, ac as getStorageUri, N as getSvgSelector, n as getTargetSelector, m as getTargetSource, K as getTextPositionSelector, L as getTextQuoteSelector, aH as googleCredential, q as hasTargetSelector, af as isArchived, t as isAssessment, l as isBodyResolved, u as isComment, ah as isDraft, r as isHighlight, s as isReference, z as isResolvedReference, y as isStubReference, v as isTag, aC as isValidEmail, aM as jobId, aK as mcpToken, aq as normalizeCoordinates, X as normalizeText, o as operations, ap as parseSvgSelector, aJ as refreshToken, aT as resourceAnnotationUri, aR as resourceUri, ar as scaleSvgToNative, aP as searchQuery, aN as userDID, au as validateAndCorrectOffsets, aB as validateData, P as validateSvgMarkup, _ as verifyPosition, w as webhooks } from './index-CJqmerJr.js';
+import * as _semiont_core from '@semiont/core';
+import { BaseUrl, ResourceUri, EntityType, AccessToken, AnnotationUri, components, Email, paths, RefreshToken, GoogleCredential, ContentFormat, SearchQuery, CloneToken, ResourceAnnotationUri, Motivation, UserDID, JobId } from '@semiont/core';
+export { BoundingBox, FragmentSelector, JWTTokenSchema, LOCALES, LocaleInfo, MatchQuality, Point, Selector, SvgSelector, TextPosition, TextPositionSelector, TextQuoteSelector, ValidatedAnnotation, ValidationFailure, ValidationResult, ValidationSuccess, createCircleSvg, createPolygonSvg, createRectangleSvg, decodeRepresentation, decodeWithCharset, extractBoundingBox, extractCharset, extractContext, findBestTextMatch, findTextWithContext, formatLocaleDisplay, getAllLocaleCodes, getAnnotationExactText, getBodySource, getBodyType, getChecksum, getCommentText, getCreator, getDerivedFrom, getExactText, getFragmentSelector, getLanguage, getLocaleEnglishName, getLocaleInfo, getLocaleNativeName, getNodeEncoding, getPrimaryMediaType, getPrimaryRepresentation, getPrimarySelector, getResourceEntityTypes, getResourceId, getStorageUri, getSvgSelector, getTargetSelector, getTargetSource, getTextPositionSelector, getTextQuoteSelector, hasTargetSelector, isArchived, isAssessment, isBodyResolved, isComment, isDraft, isHighlight, isReference, isResolvedReference, isStubReference, isTag, isValidEmail, normalizeCoordinates, normalizeText, parseSvgSelector, scaleSvgToNative, validateAndCorrectOffsets, validateData, validateSvgMarkup, verifyPosition } from './utils/index.js';
 
 /**
  * TypeScript types for Server-Sent Events (SSE) streaming
@@ -68,134 +69,6 @@ interface GenerationProgress {
     /** Human-readable status message */
     message?: string;
 }
-/**
- * Progress event for highlight detection stream
- *
- * Sent by POST /resources/:id/detect-highlights-stream
- *
- * @example
- * ```typescript
- * stream.onProgress((progress: HighlightDetectionProgress) => {
- *   if (progress.status === 'analyzing') {
- *     console.log(`Analyzing: ${progress.percentage}%`);
- *   }
- * });
- * ```
- */
-interface HighlightDetectionProgress {
-    /** Current status of highlight detection operation */
-    status: 'started' | 'analyzing' | 'creating' | 'complete' | 'error';
-    /** Resource ID being analyzed */
-    resourceId: string;
-    /** Current stage of processing */
-    stage?: 'analyzing' | 'creating';
-    /** Percentage complete (0-100) */
-    percentage?: number;
-    /** Human-readable status message */
-    message?: string;
-    /** Total highlights found */
-    foundCount?: number;
-    /** Total highlights created */
-    createdCount?: number;
-}
-/**
- * Progress event for assessment detection stream
- *
- * Sent by POST /resources/:id/detect-assessments-stream
- *
- * @example
- * ```typescript
- * stream.onProgress((progress: AssessmentDetectionProgress) => {
- *   if (progress.status === 'analyzing') {
- *     console.log(`Analyzing: ${progress.percentage}%`);
- *   }
- * });
- * ```
- */
-interface AssessmentDetectionProgress {
-    /** Current status of assessment detection operation */
-    status: 'started' | 'analyzing' | 'creating' | 'complete' | 'error';
-    /** Resource ID being analyzed */
-    resourceId: string;
-    /** Current stage of processing */
-    stage?: 'analyzing' | 'creating';
-    /** Percentage complete (0-100) */
-    percentage?: number;
-    /** Human-readable status message */
-    message?: string;
-    /** Total assessments found */
-    foundCount?: number;
-    /** Total assessments created */
-    createdCount?: number;
-}
-/**
- * Progress event for comment detection stream
- *
- * Sent by POST /resources/:id/detect-comments-stream
- *
- * @example
- * ```typescript
- * stream.onProgress((progress: CommentDetectionProgress) => {
- *   if (progress.status === 'analyzing') {
- *     console.log(`Analyzing: ${progress.percentage}%`);
- *   }
- * });
- * ```
- */
-interface CommentDetectionProgress {
-    /** Current status of comment detection operation */
-    status: 'started' | 'analyzing' | 'creating' | 'complete' | 'error';
-    /** Resource ID being analyzed */
-    resourceId: string;
-    /** Current stage of processing */
-    stage?: 'analyzing' | 'creating';
-    /** Percentage complete (0-100) */
-    percentage?: number;
-    /** Human-readable status message */
-    message?: string;
-    /** Total comments found */
-    foundCount?: number;
-    /** Total comments created */
-    createdCount?: number;
-}
-/**
- * Progress event for tag detection stream
- *
- * Sent by POST /resources/:id/detect-tags-stream
- *
- * @example
- * ```typescript
- * stream.onProgress((progress: TagDetectionProgress) => {
- *   if (progress.status === 'analyzing') {
- *     console.log(`Analyzing ${progress.currentCategory}: ${progress.percentage}%`);
- *   }
- * });
- * ```
- */
-interface TagDetectionProgress {
-    /** Current status of tag detection operation */
-    status: 'started' | 'analyzing' | 'creating' | 'complete' | 'error';
-    /** Resource ID being analyzed */
-    resourceId: string;
-    /** Current stage of processing */
-    stage?: 'analyzing' | 'creating';
-    /** Percentage complete (0-100) */
-    percentage?: number;
-    /** Currently processing this category */
-    currentCategory?: string;
-    /** Number of categories processed */
-    processedCategories?: number;
-    /** Total number of categories */
-    totalCategories?: number;
-    /** Human-readable status message */
-    message?: string;
-    /** Total tags found */
-    tagsFound?: number;
-    /** Total tags created */
-    tagsCreated?: number;
-    /** Tags found by category */
-    byCategory?: Record<string, number>;
-}
 /**
  * Resource event from real-time event stream
  *
@@ -220,43 +93,28 @@ interface TagDetectionProgress {
 /**
  * SSE stream controller interface
  *
- * Returned by all SSE methods. Provides callback registration and cleanup.
+ * Returned by all SSE methods. Events auto-emit to EventBus (required).
  *
- * @typeParam TProgress - Type of progress events
- * @typeParam TComplete - Type of completion event
+ * **Architecture Note**: All SSE methods require `eventBus` in options to enforce
+ * event-driven architecture. This is enforced at compile time via TypeScript.
  *
  * @example
  * ```typescript
- * const stream: SSEStream<DetectionProgress, DetectionProgress> =
- *   client.sse.detectAnnotations(resourceId, { entityTypes: ['Person'] });
+ * const eventBus = new EventBus();
  *
- * stream.onProgress((p) => console.log(p.message));
- * stream.onComplete((r) => console.log(`Done! Found ${r.foundCount} entities`));
- * stream.onError((e) => console.error('Failed:', e.message));
+ * // Subscribe to events
+ * eventBus.get('detection:progress').subscribe((p) => console.log(p.message));
+ * eventBus.get('detection:complete').subscribe(() => console.log('Done!'));
+ * eventBus.get('detection:failed').subscribe(({ error }) => console.error(error));
+ *
+ * // Start stream - eventBus is required (TypeScript enforced)
+ * const stream = client.sse.detectReferences(resourceId, request, { auth, eventBus });
  *
  * // Cleanup when done
  * stream.close();
  * ```
  */
-interface SSEStream<TProgress, TComplete> {
-    /**
-     * Register callback for progress events
-     *
-     * Called for each progress update (e.g., detection-started, detection-progress)
-     */
-    onProgress(callback: (progress: TProgress) => void): void;
-    /**
-     * Register callback for completion event
-     *
-     * Called once when operation completes successfully (e.g., detection-complete)
-     */
-    onComplete(callback: (result: TComplete) => void): void;
-    /**
-     * Register callback for error events
-     *
-     * Called if operation fails or stream encounters an error
-     */
-    onError(callback: (error: Error) => void): void;
+interface SSEStream {
     /**
      * Close the SSE stream and abort the connection
      *
@@ -267,7 +125,7 @@ interface SSEStream<TProgress, TComplete> {
      * ```typescript
      * // React cleanup
      * useEffect(() => {
-     *   const stream = client.sse.detectAnnotations(...);
+     *   const stream = client.sse.detectReferences(..., { auth, eventBus });
      *   return () => stream.close();
      * }, []);
      * ```
@@ -303,13 +161,6 @@ interface Logger {
     error(message: string, meta?: any): void;
 }
 
-/**
- * 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.
- */
-
 /**
  * Request body for reference detection stream
  */
@@ -367,6 +218,8 @@ interface SSEClientConfig {
  */
 interface SSERequestOptions {
     auth?: AccessToken;
+    /** EventBus for event-driven architecture (required) */
+    eventBus: _semiont_core.EventBus;
 }
 /**
  * SSE Client for real-time streaming operations
@@ -444,7 +297,7 @@ declare class SSEClient {
      * stream.close();
      * ```
      */
-    detectReferences(resourceId: ResourceUri, request: DetectReferencesStreamRequest, options?: SSERequestOptions): SSEStream<ReferenceDetectionProgress, ReferenceDetectionProgress>;
+    detectReferences(resourceId: ResourceUri, request: DetectReferencesStreamRequest, options?: SSERequestOptions): SSEStream;
     /**
      * Generate resource from annotation (streaming)
      *
@@ -482,7 +335,7 @@ declare class SSEClient {
      * stream.close();
      * ```
      */
-    generateResourceFromAnnotation(resourceId: ResourceUri, annotationId: AnnotationUri, request: GenerateResourceStreamRequest, options?: SSERequestOptions): SSEStream<GenerationProgress, GenerationProgress>;
+    generateResourceFromAnnotation(resourceId: ResourceUri, annotationId: AnnotationUri, request: GenerateResourceStreamRequest, options?: SSERequestOptions): SSEStream;
     /**
      * Detect highlights in a resource (streaming)
      *
@@ -518,7 +371,7 @@ declare class SSEClient {
      * stream.close();
      * ```
      */
-    detectHighlights(resourceId: ResourceUri, request?: DetectHighlightsStreamRequest, options?: SSERequestOptions): SSEStream<HighlightDetectionProgress, HighlightDetectionProgress>;
+    detectHighlights(resourceId: ResourceUri, request?: DetectHighlightsStreamRequest, options?: SSERequestOptions): SSEStream;
     /**
      * Detect assessments in a resource (streaming)
      *
@@ -554,7 +407,7 @@ declare class SSEClient {
      * stream.close();
      * ```
      */
-    detectAssessments(resourceId: ResourceUri, request?: DetectAssessmentsStreamRequest, options?: SSERequestOptions): SSEStream<AssessmentDetectionProgress, AssessmentDetectionProgress>;
+    detectAssessments(resourceId: ResourceUri, request?: DetectAssessmentsStreamRequest, options?: SSERequestOptions): SSEStream;
     /**
      * Detect comments in a resource (streaming)
      *
@@ -594,7 +447,7 @@ declare class SSEClient {
      * stream.close();
      * ```
      */
-    detectComments(resourceId: ResourceUri, request?: DetectCommentsStreamRequest, options?: SSERequestOptions): SSEStream<CommentDetectionProgress, CommentDetectionProgress>;
+    detectComments(resourceId: ResourceUri, request?: DetectCommentsStreamRequest, options?: SSERequestOptions): SSEStream;
     /**
      * Detect tags in a resource (streaming)
      *
@@ -635,7 +488,7 @@ declare class SSEClient {
      * stream.close();
      * ```
      */
-    detectTags(resourceId: ResourceUri, request: DetectTagsStreamRequest, options?: SSERequestOptions): SSEStream<TagDetectionProgress, TagDetectionProgress>;
+    detectTags(resourceId: ResourceUri, request: DetectTagsStreamRequest, options?: SSERequestOptions): SSEStream;
     /**
      * Subscribe to resource events (long-lived stream)
      *
@@ -672,7 +525,7 @@ declare class SSEClient {
      */
     resourceEvents(resourceId: ResourceUri, options?: SSERequestOptions & {
         onConnected?: () => void;
-    }): SSEStream<any, never>;
+    }): SSEStream;
 }
 
 /**
@@ -960,38 +813,4 @@ declare function isPdfMimeType(mimeType: string): boolean;
 type MimeCategory = 'text' | 'image' | 'unsupported';
 declare function getMimeCategory(mimeType: string): MimeCategory;
 
-/**
- * @semiont/api-client
- *
- * Complete SDK for Semiont - types, client, and utilities
- *
- * This package provides:
- * - TypeScript types generated from the OpenAPI specification
- * - A SemiontApiClient class for making API requests
- * - Utilities for working with annotations, events, and text
- *
- * Example:
- * ```typescript
- * import { SemiontApiClient, isReference, getExactText } from '@semiont/api-client';
- *
- * const client = new SemiontApiClient({ baseUrl: 'http://localhost:4000' });
- * await client.authenticateLocal('user@example.com', '123456');
- *
- * const doc = await client.createResource({
- *   name: 'My Resource',
- *   content: 'Hello World',
- *   format: 'text/plain',
- *   entityTypes: ['example']
- * });
- *
- * // Use utilities
- * if (isReference(annotation)) {
- *   const text = getExactText(annotation.target.selector);
- * }
- * ```
- */
-
-type GenerationContext = components['schemas']['GenerationContext'];
-type AnnotationLLMContextResponse = components['schemas']['AnnotationLLMContextResponse'];
-
-export { APIError, AccessToken, type AnnotationLLMContextResponse, AnnotationUri, BaseUrl, CloneToken, ContentFormat, type DetectReferencesStreamRequest, Email, EntityType, type GenerateResourceStreamRequest, type GenerationContext, type GenerationProgress, GoogleCredential, JobId, type Logger, type MimeCategory, Motivation, type ReferenceDetectionProgress, RefreshToken, type RequestOptions, ResourceAnnotationUri, ResourceUri, SSEClient, type SSEClientConfig, type SSEStream, SearchQuery, SemiontApiClient, type SemiontApiClientConfig, UserDID, components, getExtensionForMimeType, getMimeCategory, isImageMimeType, isPdfMimeType, isTextMimeType, paths };
+export { APIError, type DetectReferencesStreamRequest, type GenerateResourceStreamRequest, type GenerationProgress, type Logger, type MimeCategory, type ReferenceDetectionProgress, type RequestOptions, SSEClient, type SSEClientConfig, type SSEStream, SemiontApiClient, type SemiontApiClientConfig, getExtensionForMimeType, getMimeCategory, isImageMimeType, isPdfMimeType, isTextMimeType };

package/dist/index.js

@@ -1,13 +1,11 @@
 import ky from 'ky';
+import { resourceUri } from '@semiont/core';
 
 // src/client.ts
 
 // src/sse/stream.ts
 function createSSEStream(url, fetchOptions, config, logger) {
   const abortController = new AbortController();
-  let progressCallback = null;
-  let completeCallback = null;
-  let errorCallback = null;
   const customHandlers = /* @__PURE__ */ new Map();
   let closed = false;
   const connect = async () => {
@@ -98,7 +96,6 @@ function createSSEStream(url, fetchOptions, config, logger) {
           error: error.message,
           phase: "stream"
         });
-        errorCallback?.(error);
       } else if (error instanceof Error && error.name === "AbortError") {
         logger?.info("SSE Stream Closed", {
           type: "sse_closed",
@@ -126,21 +123,21 @@ function createSSEStream(url, fetchOptions, config, logger) {
           handler(parsed);
           return;
         }
-        progressCallback?.(parsed);
-        return;
       }
-      if (config.progressEvents.includes(eventType)) {
-        progressCallback?.(parsed);
-      }
-      if (config.completeEvent && eventType === config.completeEvent) {
-        completeCallback?.(parsed);
-        closed = true;
-        abortController.abort();
-      }
-      if (config.errorEvent && eventType === config.errorEvent) {
-        errorCallback?.(new Error(parsed.message || "Stream error"));
-        closed = true;
-        abortController.abort();
+      if (config.eventBus && config.eventPrefix) {
+        if (config.progressEvents.includes(eventType)) {
+          config.eventBus.get(`${config.eventPrefix}:progress`).next(parsed);
+        }
+        if (config.completeEvent && eventType === config.completeEvent) {
+          config.eventBus.get(`${config.eventPrefix}:complete`).next(parsed);
+          closed = true;
+          abortController.abort();
+        }
+        if (config.errorEvent && eventType === config.errorEvent) {
+          config.eventBus.get(`${config.eventPrefix}:failed`).next({ error: new Error(parsed.message || "Stream error") });
+          closed = true;
+          abortController.abort();
+        }
       }
     } catch (error) {
       console.error("[SSE] Failed to parse event data:", error);
@@ -150,15 +147,6 @@ function createSSEStream(url, fetchOptions, config, logger) {
   };
   connect();
   return {
-    onProgress(callback) {
-      progressCallback = callback;
-    },
-    onComplete(callback) {
-      completeCallback = callback;
-    },
-    onError(callback) {
-      errorCallback = callback;
-    },
     close() {
       abortController.abort();
     },
@@ -248,7 +236,9 @@ var SSEClient = class {
       {
         progressEvents: ["reference-detection-started", "reference-detection-progress"],
         completeEvent: "reference-detection-complete",
-        errorEvent: "reference-detection-error"
+        errorEvent: "reference-detection-error",
+        eventBus: options?.eventBus,
+        eventPrefix: "detection"
       },
       this.logger
     );
@@ -304,7 +294,9 @@ var SSEClient = class {
       {
         progressEvents: ["generation-started", "generation-progress"],
         completeEvent: "generation-complete",
-        errorEvent: "generation-error"
+        errorEvent: "generation-error",
+        eventBus: options?.eventBus,
+        eventPrefix: "generation"
       },
       this.logger
     );
@@ -357,7 +349,9 @@ var SSEClient = class {
       {
         progressEvents: ["highlight-detection-started", "highlight-detection-progress"],
         completeEvent: "highlight-detection-complete",
-        errorEvent: "highlight-detection-error"
+        errorEvent: "highlight-detection-error",
+        eventBus: options?.eventBus,
+        eventPrefix: "detection"
       },
       this.logger
     );
@@ -410,7 +404,9 @@ var SSEClient = class {
       {
         progressEvents: ["assessment-detection-started", "assessment-detection-progress"],
         completeEvent: "assessment-detection-complete",
-        errorEvent: "assessment-detection-error"
+        errorEvent: "assessment-detection-error",
+        eventBus: options?.eventBus,
+        eventPrefix: "detection"
       },
       this.logger
     );
@@ -467,7 +463,9 @@ var SSEClient = class {
       {
         progressEvents: ["comment-detection-started", "comment-detection-progress"],
         completeEvent: "comment-detection-complete",
-        errorEvent: "comment-detection-error"
+        errorEvent: "comment-detection-error",
+        eventBus: options?.eventBus,
+        eventPrefix: "detection"
       },
       this.logger
     );
@@ -525,7 +523,9 @@ var SSEClient = class {
       {
         progressEvents: ["tag-detection-started", "tag-detection-progress"],
         completeEvent: "tag-detection-complete",
-        errorEvent: "tag-detection-error"
+        errorEvent: "tag-detection-error",
+        eventBus: options?.eventBus,
+        eventPrefix: "detection"
       },
       this.logger
     );
@@ -630,9 +630,9 @@ var SemiontApiClient = class {
    */
   sse;
   constructor(config) {
-    const { baseUrl: baseUrl2, timeout = 3e4, retry = 2, logger } = config;
+    const { baseUrl, timeout = 3e4, retry = 2, logger } = config;
     this.logger = logger;
-    this.baseUrl = baseUrl2.endsWith("/") ? baseUrl2.slice(0, -1) : baseUrl2;
+    this.baseUrl = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
     this.http = ky.create({
       timeout,
       retry,
@@ -703,9 +703,9 @@ var SemiontApiClient = class {
   // ============================================================================
   // AUTHENTICATION
   // ============================================================================
-  async authenticatePassword(email2, password, options) {
+  async authenticatePassword(email, password, options) {
     return this.http.post(`${this.baseUrl}/api/tokens/password`, {
-      json: { email: email2, password },
+      json: { email, password },
       ...options,
       auth: options?.auth
     }).json();
@@ -968,14 +968,14 @@ var SemiontApiClient = class {
       auth: options?.auth
     }).json();
   }
-  async getAnnotation(annotationUri2, options) {
-    return this.http.get(annotationUri2, {
+  async getAnnotation(annotationUri, options) {
+    return this.http.get(annotationUri, {
       ...options,
       auth: options?.auth
     }).json();
   }
-  async getResourceAnnotation(annotationUri2, options) {
-    return this.http.get(annotationUri2, {
+  async getResourceAnnotation(annotationUri, options) {
+    return this.http.get(annotationUri, {
       ...options,
       auth: options?.auth
     }).json();
@@ -989,24 +989,24 @@ var SemiontApiClient = class {
       auth: options?.auth
     }).json();
   }
-  async deleteAnnotation(annotationUri2, options) {
-    await this.http.delete(annotationUri2, {
+  async deleteAnnotation(annotationUri, options) {
+    await this.http.delete(annotationUri, {
       ...options,
       auth: options?.auth
     });
   }
-  async updateAnnotationBody(annotationUri2, data, options) {
-    return this.http.put(`${annotationUri2}/body`, {
+  async updateAnnotationBody(annotationUri, data, options) {
+    return this.http.put(`${annotationUri}/body`, {
       json: data,
       ...options,
       auth: options?.auth
     }).json();
   }
-  async getAnnotationHistory(annotationUri2, options) {
+  async getAnnotationHistory(annotationUri, options) {
     if (options) {
-      return this.http.get(`${annotationUri2}/history`, options).json();
+      return this.http.get(`${annotationUri}/history`, options).json();
     }
-    return this.http.get(`${annotationUri2}/history`).json();
+    return this.http.get(`${annotationUri}/history`).json();
   }
   // ============================================================================
   // ENTITY TYPES
@@ -1126,67 +1126,6 @@ var SemiontApiClient = class {
     return this.http.get(`${this.baseUrl}/api/status`).json();
   }
 };
-
-// src/branded-types.ts
-function email(value) {
-  return value;
-}
-function authCode(value) {
-  return value;
-}
-function googleCredential(value) {
-  return value;
-}
-function accessToken(value) {
-  return value;
-}
-function refreshToken(value) {
-  return value;
-}
-function mcpToken(value) {
-  return value;
-}
-function cloneToken(value) {
-  return value;
-}
-function jobId(value) {
-  return value;
-}
-function userDID(value) {
-  return value;
-}
-function entityType(value) {
-  return value;
-}
-function searchQuery(value) {
-  return value;
-}
-function baseUrl(value) {
-  return value;
-}
-function resourceUri(uri) {
-  if (!uri.startsWith("http://") && !uri.startsWith("https://")) {
-    throw new TypeError(`Expected ResourceUri, got: ${uri}`);
-  }
-  return uri;
-}
-function annotationUri(uri) {
-  if (!uri.startsWith("http://") && !uri.startsWith("https://")) {
-    throw new TypeError(`Expected AnnotationUri, got: ${uri}`);
-  }
-  return uri;
-}
-function resourceAnnotationUri(uri) {
-  if (!uri.startsWith("http://") && !uri.startsWith("https://")) {
-    throw new TypeError(`Expected ResourceAnnotationUri, got: ${uri}`);
-  }
-  if (!uri.includes("/resources/") || !uri.includes("/annotations/")) {
-    throw new TypeError(`Expected nested ResourceAnnotationUri format, got: ${uri}`);
-  }
-  return uri;
-}
-
-// src/utils/annotations.ts
 function getBodySource(body) {
   if (Array.isArray(body)) {
     for (const item of body) {
@@ -1900,12 +1839,12 @@ function validateData(schema, data) {
     };
   }
 }
-function isValidEmail(email2) {
-  if (email2.length < 1 || email2.length > 255) {
+function isValidEmail(email) {
+  if (email.length < 1 || email.length > 255) {
     return false;
   }
   const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-  return emailRegex.test(email2);
+  return emailRegex.test(email);
 }
 
 // src/mime-utils.ts
@@ -1938,6 +1877,6 @@ function getMimeCategory(mimeType) {
   return "unsupported";
 }
 
-export { APIError, JWTTokenSchema, LOCALES, SSEClient, SemiontApiClient, accessToken, annotationUri, authCode, baseUrl, cloneToken, createCircleSvg, createPolygonSvg, createRectangleSvg, decodeRepresentation, decodeWithCharset, email, entityType, extractBoundingBox, extractCharset, extractContext, findBestTextMatch, findTextWithContext, formatLocaleDisplay, getAllLocaleCodes, getAnnotationExactText, getBodySource, getBodyType, getChecksum, getCommentText, getCreator, getDerivedFrom, getExactText, getExtensionForMimeType, getFragmentSelector, getLanguage, getLocaleEnglishName, getLocaleInfo, getLocaleNativeName, getMimeCategory, getNodeEncoding, getPrimaryMediaType, getPrimaryRepresentation, getPrimarySelector, getResourceEntityTypes, getResourceId, getStorageUri, getSvgSelector, getTargetSelector, getTargetSource, getTextPositionSelector, getTextQuoteSelector, googleCredential, hasTargetSelector, isArchived, isAssessment, isBodyResolved, isComment, isDraft, isHighlight, isImageMimeType, isPdfMimeType, isReference, isResolvedReference, isStubReference, isTag, isTextMimeType, isValidEmail, jobId, mcpToken, normalizeCoordinates, normalizeText, parseSvgSelector, refreshToken, resourceAnnotationUri, resourceUri, scaleSvgToNative, searchQuery, userDID, validateAndCorrectOffsets, validateData, validateSvgMarkup, verifyPosition };
+export { APIError, JWTTokenSchema, LOCALES, SSEClient, SemiontApiClient, createCircleSvg, createPolygonSvg, createRectangleSvg, decodeRepresentation, decodeWithCharset, extractBoundingBox, extractCharset, extractContext, findBestTextMatch, findTextWithContext, formatLocaleDisplay, getAllLocaleCodes, getAnnotationExactText, getBodySource, getBodyType, getChecksum, getCommentText, getCreator, getDerivedFrom, getExactText, getExtensionForMimeType, getFragmentSelector, getLanguage, getLocaleEnglishName, getLocaleInfo, getLocaleNativeName, getMimeCategory, getNodeEncoding, getPrimaryMediaType, getPrimaryRepresentation, getPrimarySelector, getResourceEntityTypes, getResourceId, getStorageUri, getSvgSelector, getTargetSelector, getTargetSource, getTextPositionSelector, getTextQuoteSelector, hasTargetSelector, isArchived, isAssessment, isBodyResolved, isComment, isDraft, isHighlight, isImageMimeType, isPdfMimeType, isReference, isResolvedReference, isStubReference, isTag, isTextMimeType, isValidEmail, normalizeCoordinates, normalizeText, parseSvgSelector, scaleSvgToNative, validateAndCorrectOffsets, validateData, validateSvgMarkup, verifyPosition };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map