@semiont/core 0.2.28-build.38 → 0.2.28

package/README.md

@@ -1,5 +1,6 @@
 # @semiont/core
 
+[![Tests](https://github.com/The-AI-Alliance/semiont/actions/workflows/package-tests.yml/badge.svg)](https://github.com/The-AI-Alliance/semiont/actions/workflows/package-tests.yml?query=branch%3Amain+is%3Asuccess+job%3A%22Test+core%22)
 [![npm version](https://img.shields.io/npm/v/@semiont/core.svg)](https://www.npmjs.com/package/@semiont/core)
 [![npm downloads](https://img.shields.io/npm/dm/@semiont/core.svg)](https://www.npmjs.com/package/@semiont/core)
 [![License](https://img.shields.io/npm/l/@semiont/core.svg)](https://github.com/The-AI-Alliance/semiont/blob/main/LICENSE)

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { components, JobId, AnnotationUri } from '@semiont/api-client';
+import { ResourceUri, AnnotationUri, components, JobId } from '@semiont/api-client';
 import { ErrorObject } from 'ajv';
 
 /**
@@ -44,6 +44,62 @@ declare function resourceId(id: string): ResourceId;
 declare function annotationId(id: string): AnnotationId;
 declare function userId(id: string): UserId;
 
+/**
+ * URI utilities for W3C annotations
+ *
+ * Converts between short resource/annotation IDs and full URIs.
+ * Full URIs are required by W3C Web Annotation Data Model.
+ */
+
+/**
+ * Convert resource ID to full URI
+ *
+ * @param id - Short resource ID (e.g., "doc-abc123")
+ * @param publicURL - Backend base URL
+ * @returns Full URI (e.g., "https://api.semiont.app/resources/doc-abc123")
+ *
+ * @example
+ * resourceIdToURI("doc-abc123", "https://api.semiont.app")
+ * // => "https://api.semiont.app/resources/doc-abc123"
+ */
+declare function resourceIdToURI(id: ResourceId, publicURL: string): ResourceUri;
+/**
+ * Extract resource ID from full URI
+ *
+ * @param uri - Full resource URI (e.g., "https://api.semiont.app/resources/doc-abc123")
+ * @returns Short resource ID (e.g., "doc-abc123")
+ * @throws Error if URI format is invalid
+ *
+ * @example
+ * uriToResourceId("https://api.semiont.app/resources/doc-abc123")
+ * // => "doc-abc123"
+ */
+declare function uriToResourceId(uri: string): ResourceId;
+/**
+ * Convert annotation ID to full URI
+ *
+ * @param id - Short annotation ID (e.g., "anno-xyz789")
+ * @param publicURL - Backend base URL
+ * @returns Full URI (e.g., "https://api.semiont.app/annotations/anno-xyz789")
+ *
+ * @example
+ * annotationIdToURI("anno-xyz789", "https://api.semiont.app")
+ * // => "https://api.semiont.app/annotations/anno-xyz789"
+ */
+declare function annotationIdToURI(id: AnnotationId, publicURL: string): AnnotationUri;
+/**
+ * Extract annotation ID from full URI
+ *
+ * @param uri - Full annotation URI (e.g., "https://api.semiont.app/annotations/anno-xyz789")
+ * @returns Short annotation ID (e.g., "anno-xyz789")
+ * @throws Error if URI format is invalid
+ *
+ * @example
+ * uriToAnnotationId("https://api.semiont.app/annotations/anno-xyz789")
+ * // => "anno-xyz789"
+ */
+declare function uriToAnnotationId(uri: string): AnnotationId;
+
 /**
  * Graph types - Models for graph connections and relationships
  */
@@ -604,6 +660,72 @@ type PlatformType$1 = 'posix' | 'container' | 'aws' | 'external';
  * via the `definition` "GraphDatabaseType".
  */
 type GraphDatabaseType = 'neo4j' | 'janusgraph' | 'neptune' | 'memory';
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "GraphServiceConfig".
+ */
+type GraphServiceConfig = {
+    [k: string]: unknown;
+} & {
+    platform: ServicePlatformConfig;
+    type: GraphDatabaseType;
+    name?: string;
+    uri?: string;
+    url?: string;
+    username?: string;
+    password?: string;
+    database?: string;
+    host?: string;
+    port?: number;
+    storage?: string;
+    index?: string;
+    endpoint?: string;
+    region?: string;
+    command?: string;
+    image?: string;
+    janusgraphVersion?: string;
+    javaOptions?: string;
+    heapSize?: string;
+    pageCacheSize?: string;
+    noAuth?: boolean;
+    dataPath?: string;
+    timeout?: number;
+    wait?: number;
+    logsEndpoint?: string;
+    tag?: string;
+    resources?: ResourceRequirements;
+    security?: SecurityRequirements;
+    build?: boolean | BuildRequirements;
+    dockerfile?: string;
+    buildContext?: string;
+    buildArgs?: {
+        [k: string]: string;
+    };
+    buildTarget?: string;
+    prebuilt?: boolean;
+    noCache?: boolean;
+    secrets?: string[];
+    labels?: {
+        [k: string]: string;
+    };
+    annotations?: {
+        [k: string]: string;
+    };
+    dependencies?: string[];
+    externalDependencies?: (string | {
+        name?: string;
+        url?: string;
+        required?: boolean;
+        healthCheck?: string;
+        [k: string]: unknown;
+    })[];
+    environment?: {
+        [k: string]: string;
+    };
+    env?: {
+        [k: string]: string;
+    };
+};
 /**
  * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
  * via the `definition` "ServicePlatformConfig".
@@ -820,70 +942,6 @@ interface DatabaseServiceConfig {
         [k: string]: unknown;
     })[];
 }
-/**
- * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
- * via the `definition` "GraphServiceConfig".
- */
-interface GraphServiceConfig {
-    platform: ServicePlatformConfig;
-    type: GraphDatabaseType;
-    name?: string;
-    uri: string;
-    url?: string;
-    username: string;
-    password: string;
-    database: string;
-    host?: string;
-    port?: number;
-    storage?: string;
-    index?: string;
-    endpoint?: string;
-    region?: string;
-    command?: string;
-    image?: string;
-    janusgraphVersion?: string;
-    javaOptions?: string;
-    heapSize?: string;
-    pageCacheSize?: string;
-    noAuth?: boolean;
-    dataPath?: string;
-    timeout?: number;
-    wait?: number;
-    logsEndpoint?: string;
-    tag?: string;
-    resources?: ResourceRequirements;
-    security?: SecurityRequirements;
-    build?: boolean | BuildRequirements;
-    dockerfile?: string;
-    buildContext?: string;
-    buildArgs?: {
-        [k: string]: string;
-    };
-    buildTarget?: string;
-    prebuilt?: boolean;
-    noCache?: boolean;
-    secrets?: string[];
-    labels?: {
-        [k: string]: string;
-    };
-    annotations?: {
-        [k: string]: string;
-    };
-    dependencies?: string[];
-    externalDependencies?: (string | {
-        name?: string;
-        url?: string;
-        required?: boolean;
-        healthCheck?: string;
-        [k: string]: unknown;
-    })[];
-    environment?: {
-        [k: string]: string;
-    };
-    env?: {
-        [k: string]: string;
-    };
-}
 /**
  * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
  * via the `definition` "FilesystemServiceConfig".
@@ -1144,6 +1202,10 @@ interface EnvironmentConfig {
         NODE_ENV?: 'development' | 'production' | 'test';
         [k: string]: unknown;
     };
+    /**
+     * Logging verbosity level
+     */
+    logLevel?: 'error' | 'warn' | 'info' | 'http' | 'debug';
     deployment?: {
         imageTagStrategy?: 'mutable' | 'immutable' | 'git-hash';
         [k: string]: unknown;
@@ -1372,4 +1434,4 @@ declare function validateSiteConfig(data: unknown): ValidationResult;
 declare const CORE_TYPES_VERSION = "0.1.0";
 declare const SDK_VERSION = "0.1.0";
 
-export { APIError, type AWSConfig, type AnnotationAddedEvent, type AnnotationBodyUpdatedEvent, type AnnotationCategory, type AnnotationId, type AnnotationRemovedEvent, type AppConfig, type BackendServiceConfig, type BaseEvent, type BodyItem, type BodyOperation, CORE_TYPES_VERSION, CREATION_METHODS, ConfigurationError, ConflictError, type CreateAnnotationInternal, type CreationMethod, type DatabaseServiceConfig, type EntityTagAddedEvent, type EntityTagRemovedEvent, type EntityTypeStats, type Environment, type EnvironmentConfig, type EventMetadata, type EventQuery, type EventSignature, type FilesystemServiceConfig, type FrontendServiceConfig, type GoogleAuthRequest, type GraphConnection, type GraphDatabaseType, type GraphPath, type GraphServiceConfig, type HttpClientConfig, type InferenceServiceConfig, type JobCompletedEvent, type JobFailedEvent, type JobProgressEvent, type JobStartedEvent, type McpServiceConfig, NotFoundError, type PlatformType, type ResourceAnnotations, type ResourceArchivedEvent, type ResourceClonedEvent, type ResourceCreatedEvent, type ResourceCreationDetails, type ResourceEvent, type ResourceEventType, type ResourceFilter, type ResourceId, type ResourceScopedEvent, type ResourceUnarchivedEvent, SDK_VERSION, ScriptError, type SemiontConfig, SemiontError, type ServiceConfig, type ServicePlatformConfig, type ServicesConfig, type SiteConfig, type StoredEvent, type SystemEvent, UnauthorizedError, type UpdateResourceInput, type UserId, ValidationError, type ValidationResult, annotationId, bodyItemsMatch, calculateChecksum, createFetchAPI, didToAgent, fetchAPI, findBodyItem, findProjectRoot, formatEventType, formatRelativeTime, generateId, generateToken, generateUuid, getAllPlatformTypes, getAnnotationIdFromEvent, getAvailableEnvironments, getEnvironmentsPath, getEventDisplayContent, getEventEmoji, getEventEntityTypes, getEventType, getNodeEnvForEnvironment, getResourceCreationDetails, getSemiontConfigPath, isAnnotationId, isArray, isBoolean, isDefined, isEventRelatedToAnnotation, isFunction, isNull, isNullish, isNumber, isObject, isProjectRoot, isResourceEvent, isResourceId, isResourceScopedEvent, isString, isSystemEvent, isUndefined, isValidEnvironment, isValidPlatformType, loadEnvironmentConfig, parseEnvironment, resourceId, userId, userToAgent, userToDid, validateEnvironment, validateEnvironmentConfig, validateSemiontConfig, validateSiteConfig, verifyChecksum };
+export { APIError, type AWSConfig, type AnnotationAddedEvent, type AnnotationBodyUpdatedEvent, type AnnotationCategory, type AnnotationId, type AnnotationRemovedEvent, type AppConfig, type BackendServiceConfig, type BaseEvent, type BodyItem, type BodyOperation, CORE_TYPES_VERSION, CREATION_METHODS, ConfigurationError, ConflictError, type CreateAnnotationInternal, type CreationMethod, type DatabaseServiceConfig, type EntityTagAddedEvent, type EntityTagRemovedEvent, type EntityTypeStats, type Environment, type EnvironmentConfig, type EventMetadata, type EventQuery, type EventSignature, type FilesystemServiceConfig, type FrontendServiceConfig, type GoogleAuthRequest, type GraphConnection, type GraphDatabaseType, type GraphPath, type GraphServiceConfig, type HttpClientConfig, type InferenceServiceConfig, type JobCompletedEvent, type JobFailedEvent, type JobProgressEvent, type JobStartedEvent, type McpServiceConfig, NotFoundError, type PlatformType, type ResourceAnnotations, type ResourceArchivedEvent, type ResourceClonedEvent, type ResourceCreatedEvent, type ResourceCreationDetails, type ResourceEvent, type ResourceEventType, type ResourceFilter, type ResourceId, type ResourceScopedEvent, type ResourceUnarchivedEvent, SDK_VERSION, ScriptError, type SemiontConfig, SemiontError, type ServiceConfig, type ServicePlatformConfig, type ServicesConfig, type SiteConfig, type StoredEvent, type SystemEvent, UnauthorizedError, type UpdateResourceInput, type UserId, ValidationError, type ValidationResult, annotationId, annotationIdToURI, bodyItemsMatch, calculateChecksum, createFetchAPI, didToAgent, fetchAPI, findBodyItem, findProjectRoot, formatEventType, formatRelativeTime, generateId, generateToken, generateUuid, getAllPlatformTypes, getAnnotationIdFromEvent, getAvailableEnvironments, getEnvironmentsPath, getEventDisplayContent, getEventEmoji, getEventEntityTypes, getEventType, getNodeEnvForEnvironment, getResourceCreationDetails, getSemiontConfigPath, isAnnotationId, isArray, isBoolean, isDefined, isEventRelatedToAnnotation, isFunction, isNull, isNullish, isNumber, isObject, isProjectRoot, isResourceEvent, isResourceId, isResourceScopedEvent, isString, isSystemEvent, isUndefined, isValidEnvironment, isValidPlatformType, loadEnvironmentConfig, parseEnvironment, resourceId, resourceIdToURI, uriToAnnotationId, uriToResourceId, userId, userToAgent, userToDid, validateEnvironment, validateEnvironmentConfig, validateSemiontConfig, validateSiteConfig, verifyChecksum };