@semiont/core 0.4.19 → 0.4.21

package/dist/index.js

@@ -117,23 +117,211 @@ var PERSISTED_EVENT_TYPES = [
 ];
 
 // src/bus-protocol.ts
-var STREAM_COMMAND_RESULT_TYPES = [
-  // Match flow — search results for binding candidates
-  "match:search-results",
-  "match:search-failed",
-  // Gather flow — assembled context for reference resolution
-  "gather:complete",
-  "gather:failed",
-  "gather:annotation-progress",
-  // Mark flow — AI-assisted annotation progress
-  "mark:progress",
-  "mark:assist-finished",
-  "mark:assist-failed",
-  // Yield flow — resource generation progress
-  "yield:progress",
-  "yield:finished",
-  "yield:failed"
+var RESOURCE_BROADCAST_TYPES = [
+  // Post-unification: job:complete / job:fail carry the "job ended on
+  // this resource" signal that yield:finished / yield:failed used to.
+  // Scope them by resource so every viewer of the affected resource
+  // — not just the initiator — can react (toast, refresh, etc.).
+  "job:complete",
+  "job:fail"
 ];
+var CHANNEL_SCHEMAS = {
+  // ── YIELD FLOW ──────────────────────────────────────────────────
+  "yield:created": null,
+  // StoredEvent
+  "yield:cloned": null,
+  "yield:updated": null,
+  "yield:moved": null,
+  "yield:representation-added": null,
+  "yield:representation-removed": null,
+  "yield:request": "YieldRequestCommand",
+  "yield:create": "YieldCreateCommand",
+  "yield:update": "YieldUpdateCommand",
+  "yield:mv": "YieldMvCommand",
+  "yield:clone": null,
+  // void
+  "yield:clone-token-requested": "YieldCloneTokenRequest",
+  "yield:clone-resource-requested": "YieldCloneResourceRequest",
+  "yield:clone-create": "YieldCloneCreateCommand",
+  "yield:create-ok": "YieldCreateOk",
+  "yield:create-failed": "CommandError",
+  "yield:update-ok": "YieldUpdateOk",
+  "yield:update-failed": null,
+  // YieldUpdateOk & CommandError
+  "yield:move-ok": "YieldMoveOk",
+  "yield:move-failed": null,
+  // { fromUri } & CommandError
+  "yield:clone-token-generated": null,
+  // { correlationId; response: CloneResourceWithTokenResponse }
+  "yield:clone-token-failed": null,
+  // { correlationId } & CommandError
+  "yield:clone-resource-result": null,
+  // { correlationId; response: GetResourceByTokenResponse }
+  "yield:clone-resource-failed": null,
+  // { correlationId } & CommandError
+  "yield:clone-created": "YieldCloneCreated",
+  "yield:clone-create-failed": null,
+  // { correlationId } & CommandError
+  // ── MARK FLOW ───────────────────────────────────────────────────
+  "mark:added": null,
+  // StoredEvent
+  "mark:removed": null,
+  "mark:body-updated": null,
+  "mark:entity-tag-added": null,
+  "mark:entity-tag-removed": null,
+  "mark:entity-type-added": null,
+  "mark:archived": null,
+  "mark:unarchived": null,
+  "mark:create-request": "MarkCreateRequest",
+  "mark:create": "MarkCreateCommand",
+  "mark:delete": "MarkDeleteCommand",
+  "mark:update-body": "MarkUpdateBodyCommand",
+  "mark:archive": "MarkArchiveCommand",
+  "mark:unarchive": "MarkUnarchiveCommand",
+  "mark:update-entity-types": "MarkUpdateEntityTypesCommand",
+  "mark:add-entity-type": "MarkAddEntityTypeCommand",
+  "mark:create-ok": "MarkCreateOk",
+  "mark:create-failed": "CommandError",
+  "mark:delete-ok": "MarkDeleteOk",
+  "mark:delete-failed": "CommandError",
+  "mark:body-update-failed": "CommandError",
+  "mark:entity-type-add-failed": "CommandError",
+  "mark:select-comment": "SelectionData",
+  "mark:select-tag": "SelectionData",
+  "mark:select-assessment": "SelectionData",
+  "mark:select-reference": "SelectionData",
+  "mark:requested": "MarkRequestedEvent",
+  "mark:cancel-pending": null,
+  // void
+  "mark:submit": "MarkSubmitEvent",
+  "mark:assist-request": "MarkAssistRequestEvent",
+  "mark:assist-cancelled": null,
+  // void
+  "mark:progress-dismiss": null,
+  // void
+  "mark:mode-toggled": null,
+  // void
+  "mark:selection-changed": "MarkSelectionChangedEvent",
+  "mark:click-changed": "MarkClickChangedEvent",
+  "mark:shape-changed": "MarkShapeChangedEvent",
+  // ── BIND FLOW ───────────────────────────────────────────────────
+  "bind:initiate": "BindInitiateCommand",
+  "bind:update-body": "BindUpdateBodyCommand",
+  "bind:body-updated": "BindBodyUpdated",
+  "bind:body-update-failed": "CommandError",
+  // ── MATCH FLOW ──────────────────────────────────────────────────
+  "match:search-requested": "MatchSearchRequest",
+  "match:search-results": "MatchSearchResult",
+  "match:search-failed": "MatchSearchFailed",
+  // ── GATHER FLOW ─────────────────────────────────────────────────
+  "gather:requested": "GatherAnnotationRequest",
+  "gather:complete": "GatherAnnotationComplete",
+  "gather:failed": null,
+  // { correlationId; annotationId } & CommandError
+  "gather:resource-requested": "GatherResourceRequest",
+  "gather:resource-complete": "GatherResourceComplete",
+  "gather:resource-failed": null,
+  // { correlationId; resourceId } & CommandError
+  "gather:summary-requested": "GatherSummaryRequest",
+  "gather:summary-result": null,
+  // { correlationId; response: Record<string, unknown> }
+  "gather:summary-failed": null,
+  // { correlationId } & CommandError
+  "gather:annotation-progress": "GatherProgress",
+  "gather:annotation-finished": "GatherAnnotationFinished",
+  "gather:progress": "GatherProgress",
+  "gather:finished": "GatherFinished",
+  // ── BROWSE FLOW ─────────────────────────────────────────────────
+  "browse:resource-requested": "BrowseResourceRequest",
+  "browse:resource-result": "BrowseResourceResult",
+  "browse:resource-failed": null,
+  // { correlationId } & CommandError
+  "browse:resources-requested": "BrowseResourcesRequest",
+  "browse:resources-result": "BrowseResourcesResult",
+  "browse:resources-failed": null,
+  "browse:annotations-requested": "BrowseAnnotationsRequest",
+  "browse:annotations-result": "BrowseAnnotationsResult",
+  "browse:annotations-failed": null,
+  "browse:annotation-requested": "BrowseAnnotationRequest",
+  "browse:annotation-result": "BrowseAnnotationResult",
+  "browse:annotation-failed": null,
+  "browse:events-requested": "BrowseEventsRequest",
+  "browse:events-result": "BrowseEventsResult",
+  "browse:events-failed": null,
+  "browse:annotation-history-requested": "BrowseAnnotationHistoryRequest",
+  "browse:annotation-history-result": "BrowseAnnotationHistoryResult",
+  "browse:annotation-history-failed": null,
+  "browse:annotation-context-requested": "BrowseAnnotationContextRequest",
+  "browse:annotation-context-result": null,
+  // { correlationId; response: Record<string, unknown> }
+  "browse:annotation-context-failed": null,
+  "browse:referenced-by-requested": "BrowseReferencedByRequest",
+  "browse:referenced-by-result": "BrowseReferencedByResult",
+  "browse:referenced-by-failed": null,
+  "browse:entity-types-requested": "BrowseEntityTypesRequest",
+  "browse:entity-types-result": "BrowseEntityTypesResult",
+  "browse:entity-types-failed": null,
+  "browse:directory-requested": "BrowseDirectoryRequest",
+  "browse:directory-result": "BrowseDirectoryResult",
+  "browse:directory-failed": null,
+  // { correlationId; path } & CommandError
+  "browse:click": "BrowseClickEvent",
+  "browse:reference-navigate": "BrowseReferenceNavigateEvent",
+  "browse:entity-type-clicked": "BrowseEntityTypeClickedEvent",
+  // ── SHELL (app-scoped UI events, fire on SemiontBrowser bus) ────
+  "panel:toggle": "BrowsePanelToggleEvent",
+  "panel:open": "BrowsePanelOpenEvent",
+  "panel:close": null,
+  // void
+  "shell:sidebar-toggle": null,
+  // void
+  "tabs:close": "BrowseResourceCloseEvent",
+  "tabs:reorder": "BrowseResourceReorderEvent",
+  "nav:link-clicked": "BrowseLinkClickedEvent",
+  "nav:push": "BrowseRouterPushEvent",
+  "nav:external": null,
+  // includes runtime `cancelFallback: () => void`
+  // ── BECKON FLOW ─────────────────────────────────────────────────
+  "beckon:hover": "BeckonHoverEvent",
+  "beckon:focus": "BeckonFocusEvent",
+  "beckon:sparkle": "BeckonSparkleEvent",
+  // ── JOB FLOW ────────────────────────────────────────────────────
+  "job:started": null,
+  // StoredEvent
+  "job:progress": null,
+  "job:completed": null,
+  "job:failed": null,
+  "job:start": "JobStartCommand",
+  "job:report-progress": "JobReportProgressCommand",
+  "job:complete": "JobCompleteCommand",
+  "job:fail": "JobFailCommand",
+  "job:queued": "JobQueuedEvent",
+  "job:cancel-requested": "JobCancelRequest",
+  "job:status-requested": "JobStatusRequest",
+  "job:create": "JobCreateCommand",
+  "job:claim": "JobClaimCommand",
+  "job:status-result": "JobStatusResult",
+  "job:status-failed": null,
+  // { correlationId } & CommandError
+  "job:created": "JobCreatedResult",
+  "job:create-failed": null,
+  "job:claimed": null,
+  // { correlationId; response: Record<string, unknown> }
+  "job:claim-failed": null,
+  // ── SETTINGS (frontend-only) ────────────────────────────────────
+  "settings:theme-changed": "SettingsThemeChangedEvent",
+  "settings:line-numbers-toggled": null,
+  // void
+  "settings:locale-changed": "SettingsLocaleChangedEvent",
+  "settings:hover-delay-changed": "SettingsHoverDelayChangedEvent",
+  // ── SSE infrastructure ──────────────────────────────────────────
+  "stream-connected": null,
+  // Record<string, never>
+  "replay-window-exceeded": null,
+  // inline payload
+  "bus:resume-gap": null
+  // inline payload
+};
 
 // src/event-utils.ts
 function getAnnotationUriFromEvent(event) {
@@ -372,6 +560,38 @@ function burstBuffer(options) {
   });
 }
 
+// src/serialize-per-key.ts
+async function serializePerKey(key, chains, work) {
+  const prev = chains.get(key) ?? Promise.resolve();
+  let result;
+  const next = prev.catch(() => {
+  }).then(async () => {
+    result = await work();
+  });
+  chains.set(key, next);
+  try {
+    await next;
+    return result;
+  } finally {
+    if (chains.get(key) === next) {
+      chains.delete(key);
+    }
+  }
+}
+
+// src/logger.ts
+function errField(error) {
+  if (error instanceof Error) {
+    return {
+      name: error.name,
+      message: error.message,
+      stack: error.stack,
+      ...error.cause !== void 0 && { cause: errField(error.cause) }
+    };
+  }
+  return error;
+}
+
 // src/annotation-utils.ts
 function findBodyItem(body, identity) {
   if (!Array.isArray(body)) {
@@ -603,6 +823,9 @@ function userToAgent(user) {
   };
 }
 function didToAgent(did) {
+  if (!did) {
+    return { type: "Person", id: "unknown", name: "unknown" };
+  }
   const parts = did.split(":");
   const encoded = parts[parts.length - 1] || "unknown";
   const name = decodeURIComponent(encoded);
@@ -627,11 +850,14 @@ function deepMerge(base, override) {
 }
 function resolveEnvVars(obj, env) {
   if (typeof obj === "string") {
-    return obj.replace(/\$\{([^}]+)\}/g, (match, varName) => {
-      if (env[varName] === void 0) {
-        throw new Error(`Environment variable ${varName} is not set (referenced in config as ${match})`);
-      }
-      return env[varName];
+    return obj.replace(/\$\{([^}]+)\}/g, (match, expr) => {
+      const sepIdx = expr.indexOf(":-");
+      const varName = sepIdx >= 0 ? expr.slice(0, sepIdx) : expr;
+      const defaultValue = sepIdx >= 0 ? expr.slice(sepIdx + 2) : void 0;
+      const value = env[varName];
+      if (value !== void 0) return value;
+      if (defaultValue !== void 0) return defaultValue;
+      throw new Error(`Environment variable ${varName} is not set (referenced in config as ${match})`);
     });
   }
   if (Array.isArray(obj)) {
@@ -949,6 +1175,6 @@ function getAllPlatformTypes() {
 var CORE_TYPES_VERSION = "0.1.0";
 var SDK_VERSION = "0.1.0";
 
-export { APIError, CORE_TYPES_VERSION, CREATION_METHODS, ConfigurationError, ConflictError, EventBus, NotFoundError, PERSISTED_EVENT_TYPES, SDK_VERSION, STREAM_COMMAND_RESULT_TYPES, ScopedEventBus, ScriptError, SemiontError, UnauthorizedError, ValidationError, accessToken, annotationId, annotationUri, applyBodyOperations, assembleAnnotation, authCode, baseUrl, burstBuffer, cloneToken, createTomlConfigLoader, didToAgent, email, entityType, findBodyItem, generateUuid, getAllPlatformTypes, getAnnotationUriFromEvent, getFragmentSelector, getSvgSelector, getTextPositionSelector, googleCredential, isAnnotationId, isArray, isBoolean, isDefined, isEventRelatedToAnnotation, isFunction, isNull, isNullish, isNumber, isObject, isResourceId, isStoredEvent, isString, isUndefined, isValidPlatformType, jobId, loadTomlConfig, mcpToken, parseEnvironment, refreshToken, resourceAnnotationUri, resourceId, resourceUri, searchQuery, userDID, userId, userToAgent, userToDid, validateEnvironment, validateSvgMarkup };
+export { APIError, CHANNEL_SCHEMAS, CORE_TYPES_VERSION, CREATION_METHODS, ConfigurationError, ConflictError, EventBus, NotFoundError, PERSISTED_EVENT_TYPES, RESOURCE_BROADCAST_TYPES, SDK_VERSION, ScopedEventBus, ScriptError, SemiontError, UnauthorizedError, ValidationError, accessToken, annotationId, annotationUri, applyBodyOperations, assembleAnnotation, authCode, baseUrl, burstBuffer, cloneToken, createTomlConfigLoader, didToAgent, email, entityType, errField, findBodyItem, generateUuid, getAllPlatformTypes, getAnnotationUriFromEvent, getFragmentSelector, getSvgSelector, getTextPositionSelector, googleCredential, isAnnotationId, isArray, isBoolean, isDefined, isEventRelatedToAnnotation, isFunction, isNull, isNullish, isNumber, isObject, isResourceId, isStoredEvent, isString, isUndefined, isValidPlatformType, jobId, loadTomlConfig, mcpToken, parseEnvironment, refreshToken, resourceAnnotationUri, resourceId, resourceUri, searchQuery, serializePerKey, userDID, userId, userToAgent, userToDid, validateEnvironment, validateSvgMarkup };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map