@semiont/api-client 0.2.45 → 0.2.46

package/dist/index.js

@@ -1,5 +1,8 @@
 import ky from 'ky';
+import { merge, firstValueFrom } from 'rxjs';
+import { filter, map, take, timeout } from 'rxjs/operators';
 import { resourceUri } from '@semiont/core';
+export { getFragmentSelector, getSvgSelector, getTextPositionSelector, validateSvgMarkup } from '@semiont/core';
 
 // src/client.ts
 
@@ -580,6 +583,54 @@ var SSEClient = class {
     }
     return stream;
   }
+  /**
+   * Subscribe to global system events (long-lived stream)
+   *
+   * Opens a long-lived SSE connection to receive system-level domain events
+   * (entity type additions, etc.) that are not scoped to a specific resource.
+   *
+   * @param options - Request options (auth token, eventBus)
+   * @returns SSE stream controller
+   *
+   * @example
+   * ```typescript
+   * const stream = sseClient.globalEvents({ auth: 'your-token', eventBus });
+   *
+   * // Events auto-emit to EventBus — subscribe there
+   * eventBus.get('make-meaning:event').subscribe((event) => {
+   *   if (event.type === 'entitytype.added') {
+   *     // Invalidate entity types query
+   *   }
+   * });
+   *
+   * // Close when no longer needed
+   * stream.close();
+   * ```
+   */
+  globalEvents(options) {
+    const url = `${this.baseUrl}/api/events/stream`;
+    const stream = createSSEStream(
+      url,
+      {
+        method: "GET",
+        headers: this.getHeaders(options.auth)
+      },
+      {
+        progressEvents: ["*"],
+        completeEvent: null,
+        errorEvent: null,
+        eventBus: options.eventBus
+      },
+      this.logger
+    );
+    if (options.onConnected) {
+      const sub = options.eventBus.get(SSE_STREAM_CONNECTED).subscribe(() => {
+        options.onConnected();
+        sub.unsubscribe();
+      });
+    }
+    return stream;
+  }
 };
 
 // src/client.ts
@@ -617,11 +668,11 @@ var SemiontApiClient = class {
    */
   sse;
   constructor(config) {
-    const { baseUrl, timeout = 3e4, retry = 2, logger } = config;
+    const { baseUrl, timeout: timeout2 = 3e4, retry = 2, logger } = config;
     this.logger = logger;
     this.baseUrl = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
     this.http = ky.create({
-      timeout,
+      timeout: timeout2,
       retry,
       hooks: {
         beforeRequest: [
@@ -888,11 +939,11 @@ var SemiontApiClient = class {
     }).json();
   }
   async updateResource(resourceUri2, data, options) {
-    return this.http.patch(resourceUri2, {
+    await this.http.patch(resourceUri2, {
       json: data,
       ...options,
       auth: options?.auth
-    }).json();
+    }).text();
   }
   async getResourceEvents(resourceUri2, options) {
     return this.http.get(`${resourceUri2}/events`, {
@@ -983,11 +1034,11 @@ var SemiontApiClient = class {
     });
   }
   async updateAnnotationBody(annotationUri, data, options) {
-    return this.http.put(`${annotationUri}/body`, {
+    await this.http.put(`${annotationUri}/body`, {
       json: data,
       ...options,
       auth: options?.auth
-    }).json();
+    });
   }
   async getAnnotationHistory(annotationUri, options) {
     if (options) {
@@ -999,18 +1050,18 @@ var SemiontApiClient = class {
   // ENTITY TYPES
   // ============================================================================
   async addEntityType(type, options) {
-    return this.http.post(`${this.baseUrl}/api/entity-types`, {
-      json: { type },
+    await this.http.post(`${this.baseUrl}/api/entity-types`, {
+      json: { tag: type },
       ...options,
       auth: options?.auth
-    }).json();
+    });
   }
   async addEntityTypesBulk(types, options) {
-    return this.http.post(`${this.baseUrl}/api/entity-types/bulk`, {
+    await this.http.post(`${this.baseUrl}/api/entity-types/bulk`, {
       json: { tags: types },
       ...options,
       auth: options?.auth
-    }).json();
+    });
   }
   async listEntityTypes(options) {
     return this.http.get(`${this.baseUrl}/api/entity-types`, {
@@ -1067,7 +1118,7 @@ var SemiontApiClient = class {
    */
   async pollJobUntilComplete(id, options) {
     const interval = options?.interval ?? 1e3;
-    const timeout = options?.timeout ?? 6e4;
+    const timeout2 = options?.timeout ?? 6e4;
     const startTime = Date.now();
     while (true) {
       const status = await this.getJobStatus(id, { auth: options?.auth });
@@ -1077,8 +1128,8 @@ var SemiontApiClient = class {
       if (status.status === "complete" || status.status === "failed" || status.status === "cancelled") {
         return status;
       }
-      if (Date.now() - startTime > timeout) {
-        throw new Error(`Job polling timeout after ${timeout}ms`);
+      if (Date.now() - startTime > timeout2) {
+        throw new Error(`Job polling timeout after ${timeout2}ms`);
       }
       await new Promise((resolve) => setTimeout(resolve, interval));
     }
@@ -1113,6 +1164,256 @@ var SemiontApiClient = class {
     return this.http.get(`${this.baseUrl}/api/status`).json();
   }
 };
+async function eventBusRequest(eventBus, requestEvent, payload, successEvent, failureEvent, timeoutMs = 3e4) {
+  const correlationId = payload.correlationId;
+  const result$ = merge(
+    eventBus.get(successEvent).pipe(
+      filter((e) => e.correlationId === correlationId),
+      map((e) => ({ ok: true, response: e.response }))
+    ),
+    eventBus.get(failureEvent).pipe(
+      filter((e) => e.correlationId === correlationId),
+      map((e) => ({ ok: false, error: e.error }))
+    )
+  ).pipe(take(1), timeout(timeoutMs));
+  const resultPromise = firstValueFrom(result$);
+  eventBus.get(requestEvent).next(payload);
+  const result = await resultPromise;
+  if (!result.ok) {
+    throw result.error;
+  }
+  return result.response;
+}
+var EventBusClient = class {
+  constructor(eventBus, timeoutMs = 3e4) {
+    this.eventBus = eventBus;
+    this.timeoutMs = timeoutMs;
+  }
+  // ========================================================================
+  // Browse Flow — Resource reads
+  // ========================================================================
+  async getResource(resourceId) {
+    return eventBusRequest(
+      this.eventBus,
+      "browse:resource-requested",
+      { correlationId: crypto.randomUUID(), resourceId },
+      "browse:resource-result",
+      "browse:resource-failed",
+      this.timeoutMs
+    );
+  }
+  async listResources(options) {
+    return eventBusRequest(
+      this.eventBus,
+      "browse:resources-requested",
+      { correlationId: crypto.randomUUID(), ...options },
+      "browse:resources-result",
+      "browse:resources-failed",
+      this.timeoutMs
+    );
+  }
+  // ========================================================================
+  // Browse Flow — Annotation reads
+  // ========================================================================
+  async getAnnotations(resourceId) {
+    return eventBusRequest(
+      this.eventBus,
+      "browse:annotations-requested",
+      { correlationId: crypto.randomUUID(), resourceId },
+      "browse:annotations-result",
+      "browse:annotations-failed",
+      this.timeoutMs
+    );
+  }
+  async getAnnotation(resourceId, annotationId) {
+    return eventBusRequest(
+      this.eventBus,
+      "browse:annotation-requested",
+      { correlationId: crypto.randomUUID(), resourceId, annotationId },
+      "browse:annotation-result",
+      "browse:annotation-failed",
+      this.timeoutMs
+    );
+  }
+  // ========================================================================
+  // Browse Flow — Event history
+  // ========================================================================
+  async getEvents(resourceId, options) {
+    return eventBusRequest(
+      this.eventBus,
+      "browse:events-requested",
+      { correlationId: crypto.randomUUID(), resourceId, ...options },
+      "browse:events-result",
+      "browse:events-failed",
+      this.timeoutMs
+    );
+  }
+  async getAnnotationHistory(resourceId, annotationId) {
+    return eventBusRequest(
+      this.eventBus,
+      "browse:annotation-history-requested",
+      { correlationId: crypto.randomUUID(), resourceId, annotationId },
+      "browse:annotation-history-result",
+      "browse:annotation-history-failed",
+      this.timeoutMs
+    );
+  }
+  // ========================================================================
+  // Bind Flow — Graph queries
+  // ========================================================================
+  async getReferencedBy(resourceId, motivation) {
+    return eventBusRequest(
+      this.eventBus,
+      "bind:referenced-by-requested",
+      { correlationId: crypto.randomUUID(), resourceId, motivation },
+      "bind:referenced-by-result",
+      "bind:referenced-by-failed",
+      this.timeoutMs
+    );
+  }
+  // ========================================================================
+  // Mark Flow — Entity types
+  // ========================================================================
+  async listEntityTypes() {
+    return eventBusRequest(
+      this.eventBus,
+      "mark:entity-types-requested",
+      { correlationId: crypto.randomUUID() },
+      "mark:entity-types-result",
+      "mark:entity-types-failed",
+      this.timeoutMs
+    );
+  }
+  addEntityType(tag, userId) {
+    this.eventBus.get("mark:add-entity-type").next({ tag, userId });
+  }
+  // ========================================================================
+  // Yield Flow — Clone tokens
+  // ========================================================================
+  async generateCloneToken(resourceId) {
+    return eventBusRequest(
+      this.eventBus,
+      "yield:clone-token-requested",
+      { correlationId: crypto.randomUUID(), resourceId },
+      "yield:clone-token-generated",
+      "yield:clone-token-failed",
+      this.timeoutMs
+    );
+  }
+  async getResourceByToken(token) {
+    return eventBusRequest(
+      this.eventBus,
+      "yield:clone-resource-requested",
+      { correlationId: crypto.randomUUID(), token },
+      "yield:clone-resource-result",
+      "yield:clone-resource-failed",
+      this.timeoutMs
+    );
+  }
+  async createResourceFromToken(options) {
+    return eventBusRequest(
+      this.eventBus,
+      "yield:clone-create",
+      { correlationId: crypto.randomUUID(), ...options },
+      "yield:clone-created",
+      "yield:clone-create-failed",
+      this.timeoutMs
+    );
+  }
+  // ========================================================================
+  // Job Control
+  // ========================================================================
+  async getJobStatus(jobId) {
+    return eventBusRequest(
+      this.eventBus,
+      "job:status-requested",
+      { correlationId: crypto.randomUUID(), jobId },
+      "job:status-result",
+      "job:status-failed",
+      this.timeoutMs
+    );
+  }
+  // ========================================================================
+  // Gather Flow — LLM context
+  // ========================================================================
+  async getAnnotationLLMContext(annotationUri, resourceUri2, options) {
+    const correlationId = crypto.randomUUID();
+    const result$ = merge(
+      this.eventBus.get("gather:complete").pipe(
+        filter((e) => e.correlationId === correlationId),
+        map((e) => ({ ok: true, response: e.response }))
+      ),
+      this.eventBus.get("gather:failed").pipe(
+        filter((e) => e.correlationId === correlationId),
+        map((e) => ({ ok: false, error: e.error }))
+      )
+    ).pipe(take(1), timeout(this.timeoutMs));
+    const resultPromise = firstValueFrom(result$);
+    this.eventBus.get("gather:requested").next({
+      correlationId,
+      annotationUri,
+      resourceUri: resourceUri2,
+      options
+    });
+    const result = await resultPromise;
+    if (!result.ok) {
+      throw result.error;
+    }
+    return result.response;
+  }
+  async getResourceLLMContext(resourceUri2, options) {
+    const correlationId = crypto.randomUUID();
+    const result$ = merge(
+      this.eventBus.get("gather:resource-complete").pipe(
+        filter((e) => e.correlationId === correlationId),
+        map((e) => ({ ok: true, response: e.context }))
+      ),
+      this.eventBus.get("gather:resource-failed").pipe(
+        filter((e) => e.correlationId === correlationId),
+        map((e) => ({ ok: false, error: e.error }))
+      )
+    ).pipe(take(1), timeout(this.timeoutMs));
+    const resultPromise = firstValueFrom(result$);
+    this.eventBus.get("gather:resource-requested").next({
+      correlationId,
+      resourceUri: resourceUri2,
+      options
+    });
+    const result = await resultPromise;
+    if (!result.ok) {
+      throw result.error;
+    }
+    return result.response;
+  }
+  // ========================================================================
+  // Bind Flow — Search
+  // ========================================================================
+  async searchResources(searchTerm) {
+    const correlationId = crypto.randomUUID();
+    const referenceId = correlationId;
+    const result$ = merge(
+      this.eventBus.get("bind:search-results").pipe(
+        filter((e) => e.correlationId === correlationId),
+        map((e) => ({ ok: true, results: e.results }))
+      ),
+      this.eventBus.get("bind:search-failed").pipe(
+        filter((e) => e.correlationId === correlationId),
+        map((e) => ({ ok: false, error: e.error }))
+      )
+    ).pipe(take(1), timeout(this.timeoutMs));
+    const resultPromise = firstValueFrom(result$);
+    this.eventBus.get("bind:search-requested").next({
+      correlationId,
+      referenceId,
+      searchTerm
+    });
+    const result = await resultPromise;
+    if (!result.ok) {
+      throw result.error;
+    }
+    return result.results;
+  }
+};
 function getBodySource(body) {
   if (Array.isArray(body)) {
     for (const item of body) {
@@ -1231,49 +1532,12 @@ function getPrimarySelector(selector) {
   }
   return selector;
 }
-function getTextPositionSelector(selector) {
-  if (!selector) return null;
-  const selectors = Array.isArray(selector) ? selector : [selector];
-  const found = selectors.find((s) => s.type === "TextPositionSelector");
-  if (!found) return null;
-  return found.type === "TextPositionSelector" ? found : null;
-}
 function getTextQuoteSelector(selector) {
   const selectors = Array.isArray(selector) ? selector : [selector];
   const found = selectors.find((s) => s.type === "TextQuoteSelector");
   if (!found) return null;
   return found.type === "TextQuoteSelector" ? found : null;
 }
-function getSvgSelector(selector) {
-  if (!selector) return null;
-  const selectors = Array.isArray(selector) ? selector : [selector];
-  const found = selectors.find((s) => s.type === "SvgSelector");
-  if (!found) return null;
-  return found.type === "SvgSelector" ? found : null;
-}
-function getFragmentSelector(selector) {
-  if (!selector) return null;
-  const selectors = Array.isArray(selector) ? selector : [selector];
-  const found = selectors.find((s) => s.type === "FragmentSelector");
-  if (!found) return null;
-  return found.type === "FragmentSelector" ? found : null;
-}
-function validateSvgMarkup(svg) {
-  if (!svg.includes('xmlns="http://www.w3.org/2000/svg"')) {
-    return 'SVG must include xmlns="http://www.w3.org/2000/svg" attribute';
-  }
-  if (!svg.includes("<svg") || !svg.includes("</svg>")) {
-    return "SVG must have opening and closing tags";
-  }
-  const shapeElements = ["rect", "circle", "ellipse", "polygon", "polyline", "path", "line"];
-  const hasShape = shapeElements.some(
-    (shape) => svg.includes(`<${shape}`) || svg.includes(`<${shape} `)
-  );
-  if (!hasShape) {
-    return "SVG must contain at least one shape element (rect, circle, ellipse, polygon, polyline, path, or line)";
-  }
-  return null;
-}
 function extractBoundingBox(svg) {
   const viewBoxMatch = svg.match(/<svg[^>]*viewBox="([^"]+)"/);
   if (viewBoxMatch) {
@@ -1798,14 +2062,14 @@ function isValidEmail(email) {
 
 // src/mime-utils.ts
 function getExtensionForMimeType(mimeType) {
-  const map = {
+  const map2 = {
     "text/plain": "txt",
     "text/markdown": "md",
     "image/png": "png",
     "image/jpeg": "jpg",
     "application/pdf": "pdf"
   };
-  return map[mimeType] || "dat";
+  return map2[mimeType] || "dat";
 }
 function isImageMimeType(mimeType) {
   return mimeType === "image/png" || mimeType === "image/jpeg";
@@ -1826,6 +2090,6 @@ function getMimeCategory(mimeType) {
   return "unsupported";
 }
 
-export { APIError, JWTTokenSchema, LOCALES, SSEClient, SSE_STREAM_CONNECTED, SemiontApiClient, buildContentCache, 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 };
+export { APIError, EventBusClient, JWTTokenSchema, LOCALES, SSEClient, SSE_STREAM_CONNECTED, SemiontApiClient, buildContentCache, createCircleSvg, createPolygonSvg, createRectangleSvg, decodeRepresentation, decodeWithCharset, extractBoundingBox, extractCharset, extractContext, findBestTextMatch, findTextWithContext, formatLocaleDisplay, getAllLocaleCodes, getAnnotationExactText, getBodySource, getBodyType, getChecksum, getCommentText, getCreator, getDerivedFrom, getExactText, getExtensionForMimeType, getLanguage, getLocaleEnglishName, getLocaleInfo, getLocaleNativeName, getMimeCategory, getNodeEncoding, getPrimaryMediaType, getPrimaryRepresentation, getPrimarySelector, getResourceEntityTypes, getResourceId, getStorageUri, getTargetSelector, getTargetSource, getTextQuoteSelector, hasTargetSelector, isArchived, isAssessment, isBodyResolved, isComment, isDraft, isHighlight, isImageMimeType, isPdfMimeType, isReference, isResolvedReference, isStubReference, isTag, isTextMimeType, isValidEmail, normalizeCoordinates, normalizeText, parseSvgSelector, scaleSvgToNative, validateAndCorrectOffsets, validateData, verifyPosition };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map