@elek-io/core 0.1.1 → 0.2.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as _elek_io_shared from '@elek-io/shared';
-import { ServiceType, ElekIoCoreOptions, BaseFile, GitTag, Sort, PaginatedList, FileType, FileReference, ExtendedCrudService, CreateGitTagProps, ReadGitTagProps, DeleteGitTagProps, ListGitTagsProps, CountGitTagsProps, UserFile, User, SetUserProps, GitInitOptions, GitCloneOptions, GitSwitchOptions, GitLogOptions, GitCommit, Asset, CreateAssetProps, ReadAssetProps, UpdateAssetProps, DeleteAssetProps, ListAssetsProps, CountAssetsProps, Collection, CreateCollectionProps, ReadCollectionProps, UpdateCollectionProps, DeleteCollectionProps, ListCollectionsProps, CountCollectionsProps, Value, CreateValueProps, ReadValueProps, UpdateValueProps, DeleteValueProps, ListValuesProps, CountValuesProps, ValidateValueProps, Entry, CreateEntryProps, ReadEntryProps, UpdateEntryProps, DeleteEntryProps, ListEntriesProps, CountEntriesProps, Project, CreateProjectProps, ReadProjectProps, UpdateProjectProps, UpgradeProjectProps, DeleteProjectProps, ListProjectsProps, ProjectExport, ConstructorElekIoCoreProps } from '@elek-io/shared';
+import { ServiceType, ElekIoCoreOptions, BaseFile, GitTag, Sort, PaginatedList, ObjectType, FileReference, ExtendedCrudService, CreateGitTagProps, ReadGitTagProps, DeleteGitTagProps, ListGitTagsProps, CountGitTagsProps, UserFile, User, SetUserProps, GitInitOptions, GitCloneOptions, GitSwitchOptions, GitLogOptions, GitCommit, Asset, CreateAssetProps, ReadAssetProps, UpdateAssetProps, DeleteAssetProps, ListAssetsProps, CountAssetsProps, Collection, CreateCollectionProps, ReadCollectionProps, UpdateCollectionProps, DeleteCollectionProps, ListCollectionsProps, CountCollectionsProps, SharedValue, CreateSharedValueProps, ReadSharedValueProps, UpdateSharedValueProps, DeleteSharedValueProps, ListSharedValuesProps, CountValuesProps, Entry, CreateEntryProps, ReadEntryProps, UpdateEntryProps, DeleteEntryProps, ListEntriesProps, CountEntriesProps, Project, CreateProjectProps, ReadProjectProps, UpdateProjectProps, UpgradeProjectProps, DeleteProjectProps, ListProjectsProps, ProjectExport, ConstructorElekIoCoreProps } from '@elek-io/shared';
 import { z } from 'zod';
 import { SpawnOptionsWithoutStdio } from 'child_process';
 import Fs from 'fs-extra';
@@ -46,7 +46,7 @@ declare abstract class AbstractCrudService {
      * @param projectId Project to get all asset references from
      * @param collectionId Only needed when requesting files of type "Entry"
      */
-    protected listReferences(type: FileType, projectId?: string, collectionId?: string): Promise<FileReference[]>;
+    protected listReferences(type: ObjectType, projectId?: string, collectionId?: string): Promise<FileReference[]>;
     private getFolderReferences;
     /**
      * Searches for all files inside given folder,
@@ -460,38 +460,40 @@ declare class CollectionService extends AbstractCrudService implements ExtendedC
 }
 
 /**
- * Service that manages CRUD functionality for Value files on disk
+ * Service that manages CRUD functionality for shared Value files on disk
  */
-declare class ValueService extends AbstractCrudService implements ExtendedCrudService<Value> {
+declare class SharedValueService extends AbstractCrudService implements ExtendedCrudService<SharedValue> {
     private jsonFileService;
     private gitService;
     constructor(options: ElekIoCoreOptions, jsonFileService: JsonFileService, gitService: GitService, assetService: AssetService);
     /**
-     * Creates a new Value
+     * Creates a new shared Value
      */
-    create(props: CreateValueProps): Promise<Value>;
+    create(props: CreateSharedValueProps): Promise<SharedValue>;
     /**
-     * Returns a Value by ID and language
+     * Returns a shared Value by ID and language
      */
-    read(props: ReadValueProps): Promise<Value>;
+    read(props: ReadSharedValueProps): Promise<SharedValue>;
     /**
-     * Updates given Value
+     * Updates given shared Values content
+     *
+     * The valueType cannot be changed after creating the shared Value
      */
-    update(props: UpdateValueProps): Promise<Value>;
+    update(props: UpdateSharedValueProps): Promise<SharedValue>;
     /**
-     * Deletes given Value
+     * Deletes given shared Value
      */
-    delete(props: DeleteValueProps): Promise<void>;
-    list(props: ListValuesProps): Promise<PaginatedList<Value>>;
+    delete(props: DeleteSharedValueProps): Promise<void>;
+    list(props: ListSharedValuesProps): Promise<PaginatedList<SharedValue>>;
     count(props: CountValuesProps): Promise<number>;
     /**
-     * Checks if given object is of type Value
+     * Checks if given object is a shared Value
      */
-    isValue(obj: BaseFile | unknown): obj is Value;
+    isSharedValue(obj: BaseFile | unknown): obj is SharedValue;
     /**
-     * Reads the given Value from disk and validates it against the ValueDefinition
+     * Reads the given shared Values content based on it's ValueType
      */
-    validate(props: ValidateValueProps): Promise<_elek_io_shared.SafeParseSuccess<string | undefined> | _elek_io_shared.SafeParseSuccess<number | undefined> | _elek_io_shared.SafeParseError<boolean> | _elek_io_shared.SafeParseSuccess<boolean | undefined>>;
+    private validate;
 }
 
 /**
@@ -501,50 +503,100 @@ declare class EntryService extends AbstractCrudService implements ExtendedCrudSe
     private jsonFileService;
     private gitService;
     private collectionService;
-    private valueService;
-    constructor(options: ElekIoCoreOptions, jsonFileService: JsonFileService, gitService: GitService, collectionService: CollectionService, valueService: ValueService);
+    private assetService;
+    private sharedValueService;
+    constructor(options: ElekIoCoreOptions, jsonFileService: JsonFileService, gitService: GitService, collectionService: CollectionService, assetService: AssetService, sharedValueService: SharedValueService);
     /**
-     * Creates a new Entry
+     * Creates a new Entry for given Collection
      */
     create(props: CreateEntryProps): Promise<Entry>;
     /**
-     * Returns an Entry by ID and language
+     * Returns an Entry from given Collection by ID and language
      */
     read(props: ReadEntryProps): Promise<Entry>;
     /**
-     * Updates Entry with given ValueReferences
+     * Updates an Entry of given Collection with new Values and shared Values
      */
     update(props: UpdateEntryProps): Promise<Entry>;
     /**
-     * Deletes given Entry
+     * Deletes given Entry from it's Collection
      */
     delete(props: DeleteEntryProps): Promise<void>;
     list(props: ListEntriesProps): Promise<_elek_io_shared.PaginatedList<{
+        values: ({
+            objectType: "value";
+            valueType: "string" | "number" | "boolean";
+            definitionId: string;
+            content?: string | number | boolean | undefined;
+        } | {
+            objectType: "value";
+            valueType: "reference";
+            content: {
+                referenceObjectType: "asset";
+                references: {
+                    id: string;
+                    language: "bg" | "cs" | "da" | "de" | "el" | "en" | "es" | "et" | "fi" | "fr" | "hu" | "it" | "ja" | "lt" | "lv" | "nl" | "pl" | "pt" | "ro" | "ru" | "sk" | "sl" | "sv" | "zh";
+                    resolved: {
+                        extension: "avif" | "gif" | "jpg" | "jpeg" | "png" | "svg" | "webp" | "pdf" | "zip" | "mp4" | "webm" | "flac" | "json";
+                        mimeType: "image/avif" | "image/gif" | "image/jpeg" | "image/png" | "image/svg+xml" | "image/webp" | "application/pdf" | "application/zip" | "video/mp4" | "video/webm" | "audio/webm" | "audio/flac";
+                        id: string;
+                        name: string;
+                        objectType: "asset";
+                        created: number;
+                        language: "bg" | "cs" | "da" | "de" | "el" | "en" | "es" | "et" | "fi" | "fr" | "hu" | "it" | "ja" | "lt" | "lv" | "nl" | "pl" | "pt" | "ro" | "ru" | "sk" | "sl" | "sv" | "zh";
+                        description: string;
+                        size: number;
+                        absolutePath: string;
+                        updated?: number | undefined;
+                    };
+                }[];
+            } | {
+                referenceObjectType: "sharedValue";
+                references: {
+                    id: string;
+                    language: "bg" | "cs" | "da" | "de" | "el" | "en" | "es" | "et" | "fi" | "fr" | "hu" | "it" | "ja" | "lt" | "lv" | "nl" | "pl" | "pt" | "ro" | "ru" | "sk" | "sl" | "sv" | "zh";
+                    resolved: {
+                        id: string;
+                        objectType: "sharedValue";
+                        created: number;
+                        language: "bg" | "cs" | "da" | "de" | "el" | "en" | "es" | "et" | "fi" | "fr" | "hu" | "it" | "ja" | "lt" | "lv" | "nl" | "pl" | "pt" | "ro" | "ru" | "sk" | "sl" | "sv" | "zh";
+                        valueType: "string" | "number" | "boolean";
+                        updated?: number | undefined;
+                        content?: string | number | boolean | undefined;
+                    };
+                };
+            };
+            definitionId: string;
+        })[];
         id: string;
-        fileType: "entry";
+        objectType: "entry";
         created: number;
         language: "bg" | "cs" | "da" | "de" | "el" | "en" | "es" | "et" | "fi" | "fr" | "hu" | "it" | "ja" | "lt" | "lv" | "nl" | "pl" | "pt" | "ro" | "ru" | "sk" | "sl" | "sv" | "zh";
-        valueReferences: {
-            definitionId: string;
-            references: {
-                id: string;
-                language: "bg" | "cs" | "da" | "de" | "el" | "en" | "es" | "et" | "fi" | "fr" | "hu" | "it" | "ja" | "lt" | "lv" | "nl" | "pl" | "pt" | "ro" | "ru" | "sk" | "sl" | "sv" | "zh";
-            };
-        }[];
         updated?: number | undefined;
     }>>;
     count(props: CountEntriesProps): Promise<number>;
     /**
-     * Checks if given object of Collection, CollectionItem,
-     * Field, Project or Asset is of type CollectionItem
+     * Checks if given object is of type Entry
      */
     isEntry(obj: BaseFile | unknown): obj is Entry;
     /**
-     * Validates referenced Values against the Collections definition
-     *
-     * @todo should probably return all errors occurring during parsing instead of throwing
+     * Returns a Value definition by ID
+     */
+    private getValueDefinitionById;
+    /**
+     * Validates given Values against it's Collections definitions
+     */
+    private validateValues;
+    /**
+     * Validates given shared Value references against it's Collections definitions
+     */
+    private resolveValueContentReference;
+    private resolveValueContentReferenceToAsset;
+    private resolveValueContentReferenceToSharedValue;
+    /**
+     * Creates an Entry from given EntryFile by resolving it's Values
      */
-    private validateValueReferences;
+    private toEntry;
 }
 
 /**
@@ -564,8 +616,8 @@ declare class SearchService extends AbstractCrudService {
      * @param project Project to search in
      * @param query Query to search for
      */
-    search(projectId: string, query: string, fileType?: FileType): Promise<{
-        type: "value" | "project" | "asset" | "collection" | "entry";
+    search(projectId: string, query: string, objectType?: ObjectType): Promise<{
+        type: "value" | "project" | "asset" | "collection" | "entry" | "sharedValue";
         id: string;
         name: string;
         matches: {
@@ -590,8 +642,7 @@ declare class ProjectService extends AbstractCrudService implements ExtendedCrud
     private assetService;
     private collectionService;
     private entryService;
-    private valueService;
-    constructor(options: ElekIoCoreOptions, jsonFileService: JsonFileService, userService: UserService, gitService: GitService, searchService: SearchService, assetService: AssetService, collectionService: CollectionService, entryService: EntryService, valueService: ValueService);
+    constructor(options: ElekIoCoreOptions, jsonFileService: JsonFileService, userService: UserService, gitService: GitService, searchService: SearchService, assetService: AssetService, collectionService: CollectionService, entryService: EntryService);
     /**
      * Creates a new Project
      */
@@ -629,8 +680,8 @@ declare class ProjectService extends AbstractCrudService implements ExtendedCrud
      * @param query     Query to search for
      * @param type      (Optional) specify the type to search for
      */
-    search(projectId: string, query: string, type?: FileType): Promise<{
-        type: "value" | "project" | "asset" | "collection" | "entry";
+    search(projectId: string, query: string, type?: ObjectType): Promise<{
+        type: "value" | "project" | "asset" | "collection" | "entry" | "sharedValue";
         id: string;
         name: string;
         matches: {
@@ -648,6 +699,7 @@ declare class ProjectService extends AbstractCrudService implements ExtendedCrud
     /**
      * Exports given Project to JSON
      *
+     * @todo do not read everything before writing to disk -> stream into file given via props
      * @todo performance tests
      * @todo add progress callback
      */
@@ -688,8 +740,8 @@ declare const pathTo: {
     collectionFile: (projectId: string, id: string) => string;
     entries: (projectId: string, collectionId: string) => string;
     entryFile: (projectId: string, collectionId: string, id: string, language: string) => string;
-    values: (projectId: string) => string;
-    valueFile: (projectId: string, id: string, language: string) => string;
+    sharedValues: (projectId: string) => string;
+    sharedValueFile: (projectId: string, id: string, language: string) => string;
     assets: (projectId: string) => string;
     assetFile: (projectId: string, id: string, language: string) => string;
     asset: (projectId: string, id: string, language: string, extension: string) => string;
@@ -781,7 +833,7 @@ declare class ElekIoCore {
     private readonly projectService;
     private readonly collectionService;
     private readonly entryService;
-    private readonly valueService;
+    private readonly sharedValueService;
     constructor(props?: ConstructorElekIoCoreProps);
     /**
      * Utility / helper functions
@@ -810,7 +862,7 @@ declare class ElekIoCore {
     /**
      * CRUD methods to work with Values
      */
-    get values(): ValueService;
+    get sharedValues(): SharedValueService;
 }
 
 export { ElekIoCore as default };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _elek_io_shared from '@elek-io/shared';
-import { ServiceType, ElekIoCoreOptions, BaseFile, GitTag, Sort, PaginatedList, FileType, FileReference, ExtendedCrudService, CreateGitTagProps, ReadGitTagProps, DeleteGitTagProps, ListGitTagsProps, CountGitTagsProps, UserFile, User, SetUserProps, GitInitOptions, GitCloneOptions, GitSwitchOptions, GitLogOptions, GitCommit, Asset, CreateAssetProps, ReadAssetProps, UpdateAssetProps, DeleteAssetProps, ListAssetsProps, CountAssetsProps, Collection, CreateCollectionProps, ReadCollectionProps, UpdateCollectionProps, DeleteCollectionProps, ListCollectionsProps, CountCollectionsProps, Value, CreateValueProps, ReadValueProps, UpdateValueProps, DeleteValueProps, ListValuesProps, CountValuesProps, ValidateValueProps, Entry, CreateEntryProps, ReadEntryProps, UpdateEntryProps, DeleteEntryProps, ListEntriesProps, CountEntriesProps, Project, CreateProjectProps, ReadProjectProps, UpdateProjectProps, UpgradeProjectProps, DeleteProjectProps, ListProjectsProps, ProjectExport, ConstructorElekIoCoreProps } from '@elek-io/shared';
+import { ServiceType, ElekIoCoreOptions, BaseFile, GitTag, Sort, PaginatedList, ObjectType, FileReference, ExtendedCrudService, CreateGitTagProps, ReadGitTagProps, DeleteGitTagProps, ListGitTagsProps, CountGitTagsProps, UserFile, User, SetUserProps, GitInitOptions, GitCloneOptions, GitSwitchOptions, GitLogOptions, GitCommit, Asset, CreateAssetProps, ReadAssetProps, UpdateAssetProps, DeleteAssetProps, ListAssetsProps, CountAssetsProps, Collection, CreateCollectionProps, ReadCollectionProps, UpdateCollectionProps, DeleteCollectionProps, ListCollectionsProps, CountCollectionsProps, SharedValue, CreateSharedValueProps, ReadSharedValueProps, UpdateSharedValueProps, DeleteSharedValueProps, ListSharedValuesProps, CountValuesProps, Entry, CreateEntryProps, ReadEntryProps, UpdateEntryProps, DeleteEntryProps, ListEntriesProps, CountEntriesProps, Project, CreateProjectProps, ReadProjectProps, UpdateProjectProps, UpgradeProjectProps, DeleteProjectProps, ListProjectsProps, ProjectExport, ConstructorElekIoCoreProps } from '@elek-io/shared';
 import { z } from 'zod';
 import { SpawnOptionsWithoutStdio } from 'child_process';
 import Fs from 'fs-extra';
@@ -46,7 +46,7 @@ declare abstract class AbstractCrudService {
      * @param projectId Project to get all asset references from
      * @param collectionId Only needed when requesting files of type "Entry"
      */
-    protected listReferences(type: FileType, projectId?: string, collectionId?: string): Promise<FileReference[]>;
+    protected listReferences(type: ObjectType, projectId?: string, collectionId?: string): Promise<FileReference[]>;
     private getFolderReferences;
     /**
      * Searches for all files inside given folder,
@@ -460,38 +460,40 @@ declare class CollectionService extends AbstractCrudService implements ExtendedC
 }
 
 /**
- * Service that manages CRUD functionality for Value files on disk
+ * Service that manages CRUD functionality for shared Value files on disk
  */
-declare class ValueService extends AbstractCrudService implements ExtendedCrudService<Value> {
+declare class SharedValueService extends AbstractCrudService implements ExtendedCrudService<SharedValue> {
     private jsonFileService;
     private gitService;
     constructor(options: ElekIoCoreOptions, jsonFileService: JsonFileService, gitService: GitService, assetService: AssetService);
     /**
-     * Creates a new Value
+     * Creates a new shared Value
      */
-    create(props: CreateValueProps): Promise<Value>;
+    create(props: CreateSharedValueProps): Promise<SharedValue>;
     /**
-     * Returns a Value by ID and language
+     * Returns a shared Value by ID and language
      */
-    read(props: ReadValueProps): Promise<Value>;
+    read(props: ReadSharedValueProps): Promise<SharedValue>;
     /**
-     * Updates given Value
+     * Updates given shared Values content
+     *
+     * The valueType cannot be changed after creating the shared Value
      */
-    update(props: UpdateValueProps): Promise<Value>;
+    update(props: UpdateSharedValueProps): Promise<SharedValue>;
     /**
-     * Deletes given Value
+     * Deletes given shared Value
      */
-    delete(props: DeleteValueProps): Promise<void>;
-    list(props: ListValuesProps): Promise<PaginatedList<Value>>;
+    delete(props: DeleteSharedValueProps): Promise<void>;
+    list(props: ListSharedValuesProps): Promise<PaginatedList<SharedValue>>;
     count(props: CountValuesProps): Promise<number>;
     /**
-     * Checks if given object is of type Value
+     * Checks if given object is a shared Value
      */
-    isValue(obj: BaseFile | unknown): obj is Value;
+    isSharedValue(obj: BaseFile | unknown): obj is SharedValue;
     /**
-     * Reads the given Value from disk and validates it against the ValueDefinition
+     * Reads the given shared Values content based on it's ValueType
      */
-    validate(props: ValidateValueProps): Promise<_elek_io_shared.SafeParseSuccess<string | undefined> | _elek_io_shared.SafeParseSuccess<number | undefined> | _elek_io_shared.SafeParseError<boolean> | _elek_io_shared.SafeParseSuccess<boolean | undefined>>;
+    private validate;
 }
 
 /**
@@ -501,50 +503,100 @@ declare class EntryService extends AbstractCrudService implements ExtendedCrudSe
     private jsonFileService;
     private gitService;
     private collectionService;
-    private valueService;
-    constructor(options: ElekIoCoreOptions, jsonFileService: JsonFileService, gitService: GitService, collectionService: CollectionService, valueService: ValueService);
+    private assetService;
+    private sharedValueService;
+    constructor(options: ElekIoCoreOptions, jsonFileService: JsonFileService, gitService: GitService, collectionService: CollectionService, assetService: AssetService, sharedValueService: SharedValueService);
     /**
-     * Creates a new Entry
+     * Creates a new Entry for given Collection
      */
     create(props: CreateEntryProps): Promise<Entry>;
     /**
-     * Returns an Entry by ID and language
+     * Returns an Entry from given Collection by ID and language
      */
     read(props: ReadEntryProps): Promise<Entry>;
     /**
-     * Updates Entry with given ValueReferences
+     * Updates an Entry of given Collection with new Values and shared Values
      */
     update(props: UpdateEntryProps): Promise<Entry>;
     /**
-     * Deletes given Entry
+     * Deletes given Entry from it's Collection
      */
     delete(props: DeleteEntryProps): Promise<void>;
     list(props: ListEntriesProps): Promise<_elek_io_shared.PaginatedList<{
+        values: ({
+            objectType: "value";
+            valueType: "string" | "number" | "boolean";
+            definitionId: string;
+            content?: string | number | boolean | undefined;
+        } | {
+            objectType: "value";
+            valueType: "reference";
+            content: {
+                referenceObjectType: "asset";
+                references: {
+                    id: string;
+                    language: "bg" | "cs" | "da" | "de" | "el" | "en" | "es" | "et" | "fi" | "fr" | "hu" | "it" | "ja" | "lt" | "lv" | "nl" | "pl" | "pt" | "ro" | "ru" | "sk" | "sl" | "sv" | "zh";
+                    resolved: {
+                        extension: "avif" | "gif" | "jpg" | "jpeg" | "png" | "svg" | "webp" | "pdf" | "zip" | "mp4" | "webm" | "flac" | "json";
+                        mimeType: "image/avif" | "image/gif" | "image/jpeg" | "image/png" | "image/svg+xml" | "image/webp" | "application/pdf" | "application/zip" | "video/mp4" | "video/webm" | "audio/webm" | "audio/flac";
+                        id: string;
+                        name: string;
+                        objectType: "asset";
+                        created: number;
+                        language: "bg" | "cs" | "da" | "de" | "el" | "en" | "es" | "et" | "fi" | "fr" | "hu" | "it" | "ja" | "lt" | "lv" | "nl" | "pl" | "pt" | "ro" | "ru" | "sk" | "sl" | "sv" | "zh";
+                        description: string;
+                        size: number;
+                        absolutePath: string;
+                        updated?: number | undefined;
+                    };
+                }[];
+            } | {
+                referenceObjectType: "sharedValue";
+                references: {
+                    id: string;
+                    language: "bg" | "cs" | "da" | "de" | "el" | "en" | "es" | "et" | "fi" | "fr" | "hu" | "it" | "ja" | "lt" | "lv" | "nl" | "pl" | "pt" | "ro" | "ru" | "sk" | "sl" | "sv" | "zh";
+                    resolved: {
+                        id: string;
+                        objectType: "sharedValue";
+                        created: number;
+                        language: "bg" | "cs" | "da" | "de" | "el" | "en" | "es" | "et" | "fi" | "fr" | "hu" | "it" | "ja" | "lt" | "lv" | "nl" | "pl" | "pt" | "ro" | "ru" | "sk" | "sl" | "sv" | "zh";
+                        valueType: "string" | "number" | "boolean";
+                        updated?: number | undefined;
+                        content?: string | number | boolean | undefined;
+                    };
+                };
+            };
+            definitionId: string;
+        })[];
         id: string;
-        fileType: "entry";
+        objectType: "entry";
         created: number;
         language: "bg" | "cs" | "da" | "de" | "el" | "en" | "es" | "et" | "fi" | "fr" | "hu" | "it" | "ja" | "lt" | "lv" | "nl" | "pl" | "pt" | "ro" | "ru" | "sk" | "sl" | "sv" | "zh";
-        valueReferences: {
-            definitionId: string;
-            references: {
-                id: string;
-                language: "bg" | "cs" | "da" | "de" | "el" | "en" | "es" | "et" | "fi" | "fr" | "hu" | "it" | "ja" | "lt" | "lv" | "nl" | "pl" | "pt" | "ro" | "ru" | "sk" | "sl" | "sv" | "zh";
-            };
-        }[];
         updated?: number | undefined;
     }>>;
     count(props: CountEntriesProps): Promise<number>;
     /**
-     * Checks if given object of Collection, CollectionItem,
-     * Field, Project or Asset is of type CollectionItem
+     * Checks if given object is of type Entry
      */
     isEntry(obj: BaseFile | unknown): obj is Entry;
     /**
-     * Validates referenced Values against the Collections definition
-     *
-     * @todo should probably return all errors occurring during parsing instead of throwing
+     * Returns a Value definition by ID
+     */
+    private getValueDefinitionById;
+    /**
+     * Validates given Values against it's Collections definitions
+     */
+    private validateValues;
+    /**
+     * Validates given shared Value references against it's Collections definitions
+     */
+    private resolveValueContentReference;
+    private resolveValueContentReferenceToAsset;
+    private resolveValueContentReferenceToSharedValue;
+    /**
+     * Creates an Entry from given EntryFile by resolving it's Values
      */
-    private validateValueReferences;
+    private toEntry;
 }
 
 /**
@@ -564,8 +616,8 @@ declare class SearchService extends AbstractCrudService {
      * @param project Project to search in
      * @param query Query to search for
      */
-    search(projectId: string, query: string, fileType?: FileType): Promise<{
-        type: "value" | "project" | "asset" | "collection" | "entry";
+    search(projectId: string, query: string, objectType?: ObjectType): Promise<{
+        type: "value" | "project" | "asset" | "collection" | "entry" | "sharedValue";
         id: string;
         name: string;
         matches: {
@@ -590,8 +642,7 @@ declare class ProjectService extends AbstractCrudService implements ExtendedCrud
     private assetService;
     private collectionService;
     private entryService;
-    private valueService;
-    constructor(options: ElekIoCoreOptions, jsonFileService: JsonFileService, userService: UserService, gitService: GitService, searchService: SearchService, assetService: AssetService, collectionService: CollectionService, entryService: EntryService, valueService: ValueService);
+    constructor(options: ElekIoCoreOptions, jsonFileService: JsonFileService, userService: UserService, gitService: GitService, searchService: SearchService, assetService: AssetService, collectionService: CollectionService, entryService: EntryService);
     /**
      * Creates a new Project
      */
@@ -629,8 +680,8 @@ declare class ProjectService extends AbstractCrudService implements ExtendedCrud
      * @param query     Query to search for
      * @param type      (Optional) specify the type to search for
      */
-    search(projectId: string, query: string, type?: FileType): Promise<{
-        type: "value" | "project" | "asset" | "collection" | "entry";
+    search(projectId: string, query: string, type?: ObjectType): Promise<{
+        type: "value" | "project" | "asset" | "collection" | "entry" | "sharedValue";
         id: string;
         name: string;
         matches: {
@@ -648,6 +699,7 @@ declare class ProjectService extends AbstractCrudService implements ExtendedCrud
     /**
      * Exports given Project to JSON
      *
+     * @todo do not read everything before writing to disk -> stream into file given via props
      * @todo performance tests
      * @todo add progress callback
      */
@@ -688,8 +740,8 @@ declare const pathTo: {
     collectionFile: (projectId: string, id: string) => string;
     entries: (projectId: string, collectionId: string) => string;
     entryFile: (projectId: string, collectionId: string, id: string, language: string) => string;
-    values: (projectId: string) => string;
-    valueFile: (projectId: string, id: string, language: string) => string;
+    sharedValues: (projectId: string) => string;
+    sharedValueFile: (projectId: string, id: string, language: string) => string;
     assets: (projectId: string) => string;
     assetFile: (projectId: string, id: string, language: string) => string;
     asset: (projectId: string, id: string, language: string, extension: string) => string;
@@ -781,7 +833,7 @@ declare class ElekIoCore {
     private readonly projectService;
     private readonly collectionService;
     private readonly entryService;
-    private readonly valueService;
+    private readonly sharedValueService;
     constructor(props?: ConstructorElekIoCoreProps);
     /**
      * Utility / helper functions
@@ -810,7 +862,7 @@ declare class ElekIoCore {
     /**
      * CRUD methods to work with Values
      */
-    get values(): ValueService;
+    get sharedValues(): SharedValueService;
 }
 
 export { ElekIoCore as default };