@semiont/api-client 0.1.0-build.6

package/dist/utils/events.js

@@ -0,0 +1,329 @@
+"use strict";
+/**
+ * Event Utilities
+ *
+ * Pure TypeScript utilities for working with resource events.
+ * No React dependencies - safe to use in any JavaScript environment.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAnnotationUriFromEvent = getAnnotationUriFromEvent;
+exports.isEventRelatedToAnnotation = isEventRelatedToAnnotation;
+exports.isResourceEvent = isResourceEvent;
+exports.formatEventType = formatEventType;
+exports.getEventEmoji = getEventEmoji;
+exports.formatRelativeTime = formatRelativeTime;
+exports.getEventDisplayContent = getEventDisplayContent;
+exports.getEventEntityTypes = getEventEntityTypes;
+exports.getResourceCreationDetails = getResourceCreationDetails;
+const annotations_1 = require("./annotations");
+// =============================================================================
+// EVENT TYPE GUARDS AND EXTRACTION
+// =============================================================================
+/**
+ * Extract annotation ID from event payload
+ * Returns null if event is not annotation-related
+ *
+ * For annotation.added: extracts full URI from payload.annotation.id
+ * For annotation.removed/body.updated: constructs full URI from payload.annotationId (UUID) + resourceId
+ */
+function getAnnotationUriFromEvent(event) {
+    const eventData = event.event;
+    const payload = eventData.payload;
+    if (!payload) {
+        return null;
+    }
+    switch (eventData.type) {
+        case 'annotation.added':
+            // annotation.added has the full annotation object with id as full URI
+            return payload.annotation?.id || null;
+        case 'annotation.removed':
+        case 'annotation.body.updated':
+            // These events have annotationId (UUID only), need to construct full URI
+            // Extract base URL from resourceId (format: http://host/resources/id)
+            if (payload.annotationId && eventData.resourceId) {
+                try {
+                    const resourceUri = eventData.resourceId;
+                    // Extract base URL by removing the /resources/{id} part
+                    const baseUrl = resourceUri.substring(0, resourceUri.lastIndexOf('/resources/'));
+                    return `${baseUrl}/annotations/${payload.annotationId}`;
+                }
+                catch (e) {
+                    return null;
+                }
+            }
+            return null;
+        default:
+            return null;
+    }
+}
+/**
+ * Check if an event is related to a specific annotation
+ */
+function isEventRelatedToAnnotation(event, annotationUri) {
+    const eventAnnotationUri = getAnnotationUriFromEvent(event);
+    return eventAnnotationUri === annotationUri;
+}
+/**
+ * Type guard to check if event is a resource event
+ */
+function isResourceEvent(event) {
+    return event &&
+        typeof event.event === 'object' &&
+        typeof event.event.id === 'string' &&
+        typeof event.event.timestamp === 'string' &&
+        typeof event.event.resourceId === 'string' &&
+        typeof event.event.type === 'string' &&
+        typeof event.metadata === 'object' &&
+        typeof event.metadata.sequenceNumber === 'number';
+}
+// =============================================================================
+// EVENT FORMATTING AND DISPLAY
+// =============================================================================
+/**
+ * Format event type for display with i18n support
+ */
+function formatEventType(type, t, payload) {
+    switch (type) {
+        case 'resource.created':
+            return t('resourceCreated');
+        case 'resource.cloned':
+            return t('resourceCloned');
+        case 'resource.archived':
+            return t('resourceArchived');
+        case 'resource.unarchived':
+            return t('resourceUnarchived');
+        case 'annotation.added': {
+            const motivation = payload?.annotation?.motivation;
+            if (motivation === 'highlighting')
+                return t('highlightAdded');
+            if (motivation === 'linking')
+                return t('referenceCreated');
+            if (motivation === 'assessing')
+                return t('assessmentAdded');
+            return t('annotationAdded');
+        }
+        case 'annotation.removed': {
+            return t('annotationRemoved');
+        }
+        case 'annotation.body.updated': {
+            return t('annotationBodyUpdated');
+        }
+        case 'entitytag.added':
+            return t('entitytagAdded');
+        case 'entitytag.removed':
+            return t('entitytagRemoved');
+        case 'entitytype.added':
+            return t('entitytypeAdded');
+        case 'job.completed':
+        case 'job.started':
+        case 'job.progress':
+        case 'job.failed':
+            return t('jobEvent');
+        default:
+            const _exhaustiveCheck = type;
+            return _exhaustiveCheck;
+    }
+}
+/**
+ * Get emoji for event type
+ * For unified annotation events, pass the payload to determine motivation
+ */
+function getEventEmoji(type, payload) {
+    switch (type) {
+        case 'resource.created':
+        case 'resource.cloned':
+        case 'resource.archived':
+        case 'resource.unarchived':
+            return '📄';
+        case 'annotation.added': {
+            const motivation = payload?.annotation?.motivation;
+            if (motivation === 'highlighting')
+                return '🟡';
+            if (motivation === 'linking')
+                return '🔵';
+            if (motivation === 'assessing')
+                return '🔴';
+            return '📝';
+        }
+        case 'annotation.removed': {
+            return '🗑️';
+        }
+        case 'annotation.body.updated': {
+            return '✏️';
+        }
+        case 'entitytag.added':
+        case 'entitytag.removed':
+            return '🏷️';
+        case 'entitytype.added':
+            return '🏷️'; // Same emoji as entitytag (global entity type collection)
+        case 'job.completed':
+            return '🔗'; // Link emoji for linked document creation
+        case 'job.started':
+        case 'job.progress':
+            return '⚙️'; // Gear for job processing
+        case 'job.failed':
+            return '❌'; // X mark for failed jobs
+        default:
+            const _exhaustiveCheck = type;
+            return _exhaustiveCheck;
+    }
+}
+/**
+ * Format timestamp as relative time with i18n support
+ */
+function formatRelativeTime(timestamp, t) {
+    const date = new Date(timestamp);
+    const now = new Date();
+    const diffMs = now.getTime() - date.getTime();
+    const diffMins = Math.floor(diffMs / 60000);
+    const diffHours = Math.floor(diffMs / 3600000);
+    const diffDays = Math.floor(diffMs / 86400000);
+    if (diffMins < 1)
+        return t('justNow');
+    if (diffMins < 60)
+        return t('minutesAgo', { count: diffMins });
+    if (diffHours < 24)
+        return t('hoursAgo', { count: diffHours });
+    if (diffDays < 7)
+        return t('daysAgo', { count: diffDays });
+    return date.toLocaleDateString();
+}
+/**
+ * Helper to truncate text for display
+ */
+function truncateText(text, maxLength = 50) {
+    const trimmed = text.trim();
+    return trimmed.length > maxLength ? trimmed.substring(0, maxLength) + '...' : trimmed;
+}
+/**
+ * Get display content from event payload - complete implementation
+ */
+function getEventDisplayContent(event, annotations, // Unified annotations array (all types)
+allEvents) {
+    const eventData = event.event;
+    const payload = eventData.payload;
+    // Use type discriminators instead of runtime typeof checks
+    switch (eventData.type) {
+        case 'resource.created':
+        case 'resource.cloned': {
+            return { exact: payload.name, isQuoted: false, isTag: false };
+        }
+        // Unified annotation events
+        case 'annotation.body.updated': {
+            // Find current annotation to get its text
+            // payload.annotationId is just the UUID, but annotation.id is the full URI
+            const annotation = annotations.find(a => a.id.endsWith(`/annotations/${payload.annotationId}`));
+            if (annotation?.target) {
+                try {
+                    const targetSelector = (0, annotations_1.getTargetSelector)(annotation.target);
+                    const exact = (0, annotations_1.getExactText)(targetSelector);
+                    if (exact) {
+                        return { exact: truncateText(exact), isQuoted: true, isTag: false };
+                    }
+                }
+                catch {
+                    // If selector parsing fails, continue to return null
+                }
+            }
+            return null;
+        }
+        case 'annotation.removed': {
+            // Find the original annotation.added event to get the text
+            // payload.annotationId is just the UUID, but annotation.id in the added event is the full URI
+            const addedEvent = allEvents.find(e => e.event.type === 'annotation.added' &&
+                e.event.payload.annotation?.id?.endsWith(`/annotations/${payload.annotationId}`));
+            if (addedEvent) {
+                const addedPayload = addedEvent.event.payload;
+                try {
+                    const exact = (0, annotations_1.getExactText)(addedPayload.annotation.target.selector);
+                    if (exact) {
+                        return { exact: truncateText(exact), isQuoted: true, isTag: false };
+                    }
+                }
+                catch {
+                    // If selector parsing fails, return null
+                }
+            }
+            return null;
+        }
+        case 'annotation.added': {
+            // New unified event structure - annotation is in payload
+            try {
+                const exact = (0, annotations_1.getExactText)(payload.annotation.target.selector);
+                if (exact) {
+                    return { exact: truncateText(exact), isQuoted: true, isTag: false };
+                }
+            }
+            catch {
+                // If selector parsing fails, return null
+            }
+            return null;
+        }
+        case 'entitytag.added':
+        case 'entitytag.removed': {
+            return { exact: payload.entityType, isQuoted: false, isTag: true };
+        }
+        case 'job.completed': {
+            // Find the annotation that was used to generate the resource
+            if (payload.annotationUri) {
+                const annotation = annotations.find(a => a.id === payload.annotationUri);
+                if (annotation?.target) {
+                    try {
+                        const targetSelector = (0, annotations_1.getTargetSelector)(annotation.target);
+                        const exact = (0, annotations_1.getExactText)(targetSelector);
+                        if (exact) {
+                            return { exact: truncateText(exact), isQuoted: true, isTag: false };
+                        }
+                    }
+                    catch {
+                        // If selector parsing fails, continue to return null
+                    }
+                }
+            }
+            return null;
+        }
+        default:
+            return null;
+    }
+}
+/**
+ * Get entity types from event payload
+ */
+function getEventEntityTypes(event) {
+    const eventData = event.event;
+    if (eventData.type === 'annotation.added') {
+        const payload = eventData.payload;
+        const motivation = payload?.annotation?.motivation;
+        if (motivation === 'linking') {
+            return payload.annotation?.body?.entityTypes ?? [];
+        }
+    }
+    return [];
+}
+/**
+ * Get resource creation details from event
+ */
+function getResourceCreationDetails(event) {
+    const eventData = event.event;
+    const payload = eventData.payload;
+    if (eventData.type === 'resource.created') {
+        return {
+            type: 'created',
+            method: payload.creationMethod || 'unknown',
+            userId: eventData.userId,
+            metadata: payload.metadata,
+        };
+    }
+    if (eventData.type === 'resource.cloned') {
+        return {
+            type: 'cloned',
+            method: payload.creationMethod || 'clone',
+            userId: eventData.userId,
+            sourceDocId: payload.parentResourceId,
+            parentResourceId: payload.parentResourceId,
+            metadata: payload.metadata,
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=events.js.map

package/dist/utils/events.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * SDK utilities for @semiont/api-client
+ *
+ * Pure TypeScript helpers for working with Semiont data structures.
+ * No React dependencies - safe to use in any JavaScript environment.
+ */
+export * from './annotations';
+export * from './events';
+export * from './locales';
+export * from './resources';
+export * from './validation';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * SDK utilities for @semiont/api-client
+ *
+ * Pure TypeScript helpers for working with Semiont data structures.
+ * No React dependencies - safe to use in any JavaScript environment.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./annotations"), exports);
+__exportStar(require("./events"), exports);
+__exportStar(require("./locales"), exports);
+__exportStar(require("./resources"), exports);
+__exportStar(require("./validation"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,gDAA8B;AAC9B,2CAAyB;AACzB,4CAA0B;AAC1B,8CAA4B;AAC5B,+CAA6B"}

package/dist/utils/locales.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Locale information
+ * Copied from SDK for frontend use
+ */
+export interface LocaleInfo {
+    code: string;
+    nativeName: string;
+    englishName: string;
+}
+export declare const LOCALES: readonly LocaleInfo[];
+/**
+ * Get locale information by code
+ */
+export declare function getLocaleInfo(code: string | undefined): LocaleInfo | undefined;
+/**
+ * Get the native name of a language by its locale code
+ */
+export declare function getLocaleNativeName(code: string | undefined): string | undefined;
+/**
+ * Get the English name of a language by its locale code
+ */
+export declare function getLocaleEnglishName(code: string | undefined): string | undefined;
+/**
+ * Format locale code for display as "Native Name (code)"
+ */
+export declare function formatLocaleDisplay(code: string | undefined): string | undefined;
+/**
+ * Get all supported locale codes
+ */
+export declare function getAllLocaleCodes(): readonly string[];
+//# sourceMappingURL=locales.d.ts.map

package/dist/utils/locales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../src/utils/locales.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,OAAO,EAAE,SAAS,UAAU,EA8B/B,CAAC;AAOX;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAG9E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEhF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEjF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAOhF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAErD"}

package/dist/utils/locales.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * Locale information
+ * Copied from SDK for frontend use
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOCALES = void 0;
+exports.getLocaleInfo = getLocaleInfo;
+exports.getLocaleNativeName = getLocaleNativeName;
+exports.getLocaleEnglishName = getLocaleEnglishName;
+exports.formatLocaleDisplay = formatLocaleDisplay;
+exports.getAllLocaleCodes = getAllLocaleCodes;
+exports.LOCALES = [
+    { code: 'ar', nativeName: 'العربية', englishName: 'Arabic' },
+    { code: 'bn', nativeName: 'বাংলা', englishName: 'Bengali' },
+    { code: 'cs', nativeName: 'Čeština', englishName: 'Czech' },
+    { code: 'da', nativeName: 'Dansk', englishName: 'Danish' },
+    { code: 'de', nativeName: 'Deutsch', englishName: 'German' },
+    { code: 'el', nativeName: 'Ελληνικά', englishName: 'Greek' },
+    { code: 'en', nativeName: 'English', englishName: 'English' },
+    { code: 'es', nativeName: 'Español', englishName: 'Spanish' },
+    { code: 'fa', nativeName: 'فارسی', englishName: 'Persian' },
+    { code: 'fi', nativeName: 'Suomi', englishName: 'Finnish' },
+    { code: 'fr', nativeName: 'Français', englishName: 'French' },
+    { code: 'he', nativeName: 'עברית', englishName: 'Hebrew' },
+    { code: 'hi', nativeName: 'हिन्दी', englishName: 'Hindi' },
+    { code: 'id', nativeName: 'Bahasa Indonesia', englishName: 'Indonesian' },
+    { code: 'it', nativeName: 'Italiano', englishName: 'Italian' },
+    { code: 'ja', nativeName: '日本語', englishName: 'Japanese' },
+    { code: 'ko', nativeName: '한국어', englishName: 'Korean' },
+    { code: 'ms', nativeName: 'Bahasa Melayu', englishName: 'Malay' },
+    { code: 'nl', nativeName: 'Nederlands', englishName: 'Dutch' },
+    { code: 'no', nativeName: 'Norsk', englishName: 'Norwegian' },
+    { code: 'pl', nativeName: 'Polski', englishName: 'Polish' },
+    { code: 'pt', nativeName: 'Português', englishName: 'Portuguese' },
+    { code: 'ro', nativeName: 'Română', englishName: 'Romanian' },
+    { code: 'sv', nativeName: 'Svenska', englishName: 'Swedish' },
+    { code: 'th', nativeName: 'ไทย', englishName: 'Thai' },
+    { code: 'tr', nativeName: 'Türkçe', englishName: 'Turkish' },
+    { code: 'uk', nativeName: 'Українська', englishName: 'Ukrainian' },
+    { code: 'vi', nativeName: 'Tiếng Việt', englishName: 'Vietnamese' },
+    { code: 'zh', nativeName: '中文', englishName: 'Chinese' },
+];
+// Create lookup map for efficient access
+const localeByCode = new Map(exports.LOCALES.map(locale => [locale.code.toLowerCase(), locale]));
+/**
+ * Get locale information by code
+ */
+function getLocaleInfo(code) {
+    if (!code)
+        return undefined;
+    return localeByCode.get(code.toLowerCase());
+}
+/**
+ * Get the native name of a language by its locale code
+ */
+function getLocaleNativeName(code) {
+    return getLocaleInfo(code)?.nativeName;
+}
+/**
+ * Get the English name of a language by its locale code
+ */
+function getLocaleEnglishName(code) {
+    return getLocaleInfo(code)?.englishName;
+}
+/**
+ * Format locale code for display as "Native Name (code)"
+ */
+function formatLocaleDisplay(code) {
+    if (!code)
+        return undefined;
+    const info = getLocaleInfo(code);
+    if (!info)
+        return code;
+    return `${info.nativeName} (${code.toLowerCase()})`;
+}
+/**
+ * Get all supported locale codes
+ */
+function getAllLocaleCodes() {
+    return exports.LOCALES.map(l => l.code);
+}
+//# sourceMappingURL=locales.js.map

package/dist/utils/locales.js.map

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

package/dist/utils/resources.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Helper functions for working with W3C ResourceDescriptor
+ */
+import type { components } from '../types';
+type ResourceDescriptor = components['schemas']['ResourceDescriptor'];
+type Representation = components['schemas']['Representation'];
+/**
+ * Get the resource ID from @id property
+ *
+ * For internal resources: extracts UUID from "http://localhost:4000/resources/{uuid}"
+ * For external resources: returns undefined
+ *
+ * This is used for routing - the frontend URL should contain only the resource ID,
+ * not the full HTTP URI.
+ */
+export declare function getResourceId(resource: ResourceDescriptor | undefined): string | undefined;
+/**
+ * Get the primary representation (first or only representation)
+ */
+export declare function getPrimaryRepresentation(resource: ResourceDescriptor | undefined): Representation | undefined;
+/**
+ * Get the media type from the primary representation
+ */
+export declare function getPrimaryMediaType(resource: ResourceDescriptor | undefined): string | undefined;
+/**
+ * Get the checksum from the primary representation
+ */
+export declare function getChecksum(resource: ResourceDescriptor | undefined): string | undefined;
+/**
+ * Get the language from the primary representation
+ */
+export declare function getLanguage(resource: ResourceDescriptor | undefined): string | undefined;
+export {};
+//# sourceMappingURL=resources.d.ts.map

package/dist/utils/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/utils/resources.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,KAAK,kBAAkB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,CAAC;AACtE,KAAK,cAAc,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,gBAAgB,CAAC,CAAC;AAE9D;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAe1F;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAM7G;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEhG;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAExF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAExF"}

package/dist/utils/resources.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * Helper functions for working with W3C ResourceDescriptor
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getResourceId = getResourceId;
+exports.getPrimaryRepresentation = getPrimaryRepresentation;
+exports.getPrimaryMediaType = getPrimaryMediaType;
+exports.getChecksum = getChecksum;
+exports.getLanguage = getLanguage;
+/**
+ * Get the resource ID from @id property
+ *
+ * For internal resources: extracts UUID from "http://localhost:4000/resources/{uuid}"
+ * For external resources: returns undefined
+ *
+ * This is used for routing - the frontend URL should contain only the resource ID,
+ * not the full HTTP URI.
+ */
+function getResourceId(resource) {
+    if (!resource)
+        return undefined;
+    const fullId = resource['@id'];
+    // For internal resources, extract the last path segment
+    // http://localhost:4000/resources/{uuid} -> {uuid}
+    if (fullId.includes('/resources/')) {
+        const parts = fullId.split('/resources/');
+        const lastPart = parts[parts.length - 1];
+        return lastPart || undefined;
+    }
+    // For external resources, cannot extract ID
+    return undefined;
+}
+/**
+ * Get the primary representation (first or only representation)
+ */
+function getPrimaryRepresentation(resource) {
+    if (!resource?.representations)
+        return undefined;
+    const reps = Array.isArray(resource.representations)
+        ? resource.representations
+        : [resource.representations];
+    return reps[0];
+}
+/**
+ * Get the media type from the primary representation
+ */
+function getPrimaryMediaType(resource) {
+    return getPrimaryRepresentation(resource)?.mediaType;
+}
+/**
+ * Get the checksum from the primary representation
+ */
+function getChecksum(resource) {
+    return getPrimaryRepresentation(resource)?.checksum;
+}
+/**
+ * Get the language from the primary representation
+ */
+function getLanguage(resource) {
+    return getPrimaryRepresentation(resource)?.language;
+}
+//# sourceMappingURL=resources.js.map

package/dist/utils/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/utils/resources.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAgBH,sCAeC;AAKD,4DAMC;AAKD,kDAEC;AAKD,kCAEC;AAKD,kCAEC;AAxDD;;;;;;;;GAQG;AACH,SAAgB,aAAa,CAAC,QAAwC;IACpE,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE/B,wDAAwD;IACxD,mDAAmD;IACnD,IAAI,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACzC,OAAO,QAAQ,IAAI,SAAS,CAAC;IAC/B,CAAC;IAED,4CAA4C;IAC5C,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAgB,wBAAwB,CAAC,QAAwC;IAC/E,IAAI,CAAC,QAAQ,EAAE,eAAe;QAAE,OAAO,SAAS,CAAC;IACjD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;QAClD,CAAC,CAAC,QAAQ,CAAC,eAAe;QAC1B,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAC/B,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,QAAwC;IAC1E,OAAO,wBAAwB,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,QAAwC;IAClE,OAAO,wBAAwB,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,QAAwC;IAClE,OAAO,wBAAwB,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;AACtD,CAAC"}