@api-client/core 0.5.2 → 0.5.3

package/build/src/models/store/File.js

@@ -1,5 +1,20 @@
+import { Kind as UserKind } from './User.js';
+import { Thing } from '../Thing.js';
+import v4 from '../../lib/uuid.js';
 export const DefaultOwner = 'default';
 export class StoredFile {
+    /**
+     * The kind of the File
+     */
+    kind = '';
+    /**
+     * The identifier of the entity
+     */
+    key = '';
+    /**
+     * The name of the environment.
+     */
+    info = Thing.fromName('');
     /**
      * The list of parents of the object. It is an ordered list of parents
      * from the top (first element) to the lowest parent in the tree (last element).
@@ -20,52 +35,138 @@ export class StoredFile {
      */
     deleted;
     /**
-     * The timestamp of when the file was deleted.
+     * The information about the delete information.
+     * Always set when the `delete` is true.
      */
-    deletedTime;
-    /**
-     * The id of the user that has deleted the file.
-     */
-    deletingUser;
+    deletedInfo;
     /**
      * The owner of this space. The id of the User object.
      * Set to `default` when there are no users in the system (no authentication).
      */
-    owner = '';
+    owner = DefaultOwner;
+    /**
+     * The last modification made to this file.
+     */
+    lastModified = { user: '', time: 0, byMe: false };
+    /**
+     * An arbitrary list of labels applied to the file.
+     */
+    labels;
     new(init) {
-        const { parents = [], permissionIds = [], deleted, deletedTime, deletingUser, owner = DefaultOwner } = init;
+        const { key = v4(), info, kind, parents = [], permissionIds = [], deleted, deletedInfo, owner = DefaultOwner, lastModified, labels } = init;
+        this.key = key;
+        this.kind = kind;
+        if (info) {
+            this.info = new Thing(info);
+        }
+        else {
+            this.info = Thing.fromName('');
+        }
         this.parents = parents;
         this.permissionIds = permissionIds;
         this.owner = owner;
+        this.lastModified = lastModified || { user: '', time: 0, byMe: false };
         if (typeof deleted === 'boolean') {
             this.deleted = deleted;
-            this.deletedTime = deletedTime;
-            this.deletingUser = deletingUser;
+            this.deletedInfo = deletedInfo;
         }
         else {
             this.deleted = undefined;
-            this.deletedTime = undefined;
-            this.deletingUser = undefined;
+            this.deletedInfo = undefined;
+        }
+        if (Array.isArray(labels)) {
+            this.labels = labels;
+        }
+        else {
+            this.labels = undefined;
         }
     }
     toJSON() {
         const { owner = DefaultOwner } = this;
         const result = {
+            key: this.key,
+            kind: this.kind,
+            info: this.info.toJSON(),
             parents: this.parents,
             permissionIds: this.permissionIds,
+            lastModified: this.lastModified,
             owner,
         };
-        if (typeof this.deleted === 'boolean') {
+        if (this.deleted) {
             result.deleted = this.deleted;
-            if (this.deletedTime) {
-                result.deletedTime = this.deletedTime;
-            }
-            if (this.deletingUser) {
-                result.deletingUser = this.deletingUser;
-            }
+            result.deletedInfo = this.deletedInfo;
+        }
+        if (Array.isArray(this.labels)) {
+            result.labels = this.labels;
         }
         return result;
     }
+    /**
+     * Updates the "lastModified" value.
+     * A helper method for a common task.
+     *
+     * @param user The user that modifies the entity.
+     */
+    setLastModified(user) {
+        if (!user) {
+            throw new Error(`The user is required.`);
+        }
+        if (user.kind !== UserKind) {
+            throw new Error(`Invalid value for the user when setting "lastModified".`);
+        }
+        this.lastModified = {
+            byMe: false,
+            time: Date.now(),
+            user: user.key,
+            name: user.name,
+        };
+    }
+    /**
+     * Adds a label to the list of labels.
+     *
+     * It makes sure the value is a valid, non-empty string and the `labels` array is set.
+     *
+     * It does nothing when the label already exists.
+     *
+     * @param label The label to set.
+     */
+    addLabel(label) {
+        if (typeof label !== 'string') {
+            throw new Error(`The label must be a string.`);
+        }
+        if (!label.trim()) {
+            throw new Error(`The label is required.`);
+        }
+        if (!Array.isArray(this.labels)) {
+            this.labels = [];
+        }
+        if (this.labels.includes(label)) {
+            return;
+        }
+        this.labels.push(label);
+    }
+    /**
+     * Marks the entity as deleted.
+     *
+     * A helper method for a common task.
+     *
+     * @param user The user that deletes the entity.
+     */
+    setDeleted(user) {
+        if (!user) {
+            throw new Error(`The user is required.`);
+        }
+        if (user.kind !== UserKind) {
+            throw new Error(`Invalid value for the user when setting "lastModified".`);
+        }
+        this.deleted = true;
+        this.deletedInfo = {
+            byMe: false,
+            time: Date.now(),
+            user: user.key,
+            name: user.name,
+        };
+    }
 }
 export class File extends StoredFile {
     /**

package/build/src/models/store/File.js.map

@@ -1 +1 @@
-{"version":3,"file":"File.js","sourceRoot":"","sources":["../../../../src/models/store/File.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAC;AAqDtC,MAAM,OAAO,UAAU;IACrB;;;;;;OAMG;IACH,OAAO,GAAa,EAAE,CAAC;IACvB;;;;;OAKG;IACH,aAAa,GAAa,EAAE,CAAC;IAC7B;;OAEG;IACH,OAAO,CAAW;IAClB;;OAEG;IACH,WAAW,CAAU;IACrB;;OAEG;IACH,YAAY,CAAU;IACtB;;;OAGG;IACH,KAAK,GAAG,EAAE,CAAC;IAEX,GAAG,CAAC,IAAiB;QACnB,MAAM,EAAE,OAAO,GAAC,EAAE,EAAE,aAAa,GAAC,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,GAAG,YAAY,EAAE,GAAG,IAAI,CAAC;QACxG,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,OAAO,OAAO,KAAK,SAAS,EAAE;YAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACvB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;YAC/B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;SAClC;aAAM;YACL,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;YACzB,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;YAC7B,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;SAC/B;IACH,CAAC;IAED,MAAM;QACJ,MAAM,EAAE,KAAK,GAAG,YAAY,EAAE,GAAG,IAAI,CAAC;QACtC,MAAM,MAAM,GAAgB;YAC1B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,KAAK;SACN,CAAC;QACF,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE;YACrC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAE9B,IAAI,IAAI,CAAC,WAAW,EAAE;gBACpB,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;aACvC;YACD,IAAI,IAAI,CAAC,YAAY,EAAE;gBACrB,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;aACzC;SACF;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,MAAM,OAAO,IAAK,SAAQ,UAAU;IAClC;;;;;OAKG;IACH,WAAW,GAAkB,EAAE,CAAC;IAEhC,GAAG,CAAC,IAAW;QACb,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChB,MAAM,EAAE,WAAW,GAAC,EAAE,EAAE,GAAG,IAAI,CAAC;QAChC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,MAAM;QACJ,MAAM,MAAM,GAAU;YACpB,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}
+{"version":3,"file":"File.js","sourceRoot":"","sources":["../../../../src/models/store/File.ts"],"names":[],"mappings":"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"}

package/build/src/models/store/Modification.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Information about a modification of a File.
+ */
+export interface IModification {
+    /**
+     * The key of the user modifying the record.
+     */
+    user: string;
+    /**
+     * User name modifying the record. May not be set when there's no actual user.
+     */
+    name?: string;
+    /**
+     * Whether the modification was performed by the requesting the data user.
+     *
+     * Note for store implementers, this field should not be stored and populated every time the
+     * record is requested.
+     */
+    byMe: boolean;
+    /**
+     * A timestamp when the object was modified.
+     */
+    time: number;
+}

package/build/src/models/store/Modification.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Modification.js.map

package/build/src/models/store/Modification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Modification.js","sourceRoot":"","sources":["../../../../src/models/store/Modification.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@api-client/core",
   "description": "The API Client's core client library. Works in NodeJS and in a ES enabled browser.",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "license": "Apache-2.0",
   "main": "build/index.js",
   "module": "build/index.js",

package/src/models/Project.ts

@@ -0,0 +1,110 @@
+import { IFile, File, DefaultOwner } from "./store/File.js";
+import { Kind as ThingKind } from './Thing.js';
+import { HttpProject, IHttpProject } from './HttpProject.js';
+import v4 from '../lib/uuid.js';
+
+export const Kind = 'Core#Project';
+
+/**
+ * This model represents a meta data for an HTTP project stored with the data store.
+ * This does not include the HTTP project entity, though, it is referenced through the same key.
+ * 
+ * A concept of a project is similar to a Workspace. It is an object that is rendered in the UIs
+ * like a workspace but has a different meaning. On the store side, when listing workspace items,
+ * both spaces and projects are returned in a single query.
+ */
+export interface IProject extends IFile {
+  kind: typeof Kind;
+}
+
+/**
+ * This model represents a meta data for an HTTP project stored with the data store.
+ * This does not include the HTTP project entity, though, it is referenced through the same key.
+ * 
+ * A concept of a project is similar to a Workspace. It is an object that is rendered in the UIs
+ * like a workspace but has a different meaning. On the store side, when listing workspace items,
+ * both spaces and projects are returned in a single query.
+ */
+export class Project extends File {
+  kind = Kind;
+
+  static fromProject(project: HttpProject | IHttpProject): Project {
+    let final: IHttpProject;
+    if (typeof (project as HttpProject).toJSON === 'function') {
+      final = (project as HttpProject).toJSON();
+    } else {
+      final = project as IHttpProject;
+    }
+    const init: IProject = {
+      kind: Kind,
+      key: final.key,
+      info: { ...final.info },
+      lastModified: { user: '', time: 0, byMe: false },
+      owner: DefaultOwner,
+      parents: [],
+      permissionIds: [],
+      permissions: [],
+    };
+    return new Project(init);
+  }
+
+  /**
+   * @param input The environment definition used to restore the state.
+   */
+  constructor(input?: string | IProject) {
+    super();
+    let init: IProject;
+    if (typeof input === 'string') {
+      init = JSON.parse(input);
+    } else if (typeof input === 'object') {
+      init = input;
+    } else {
+      init = {
+        kind: Kind,
+        key: v4(),
+        info: {
+          kind: ThingKind,
+          name: '',
+        },
+        owner: DefaultOwner,
+        parents: [],
+        permissionIds: [],
+        permissions: [],
+        lastModified: { user: '', time: 0, byMe: false },
+      };
+    }
+    this.new(init);
+  }
+
+  /**
+   * Creates a new environment clearing anything that is so far defined.
+   * 
+   * Note, this throws an error when the environment is not a space. 
+   */
+  new(init: IProject): void {
+    if (!Project.isWorkspace(init)) {
+      throw new Error(`Not a space.`);
+    }
+    super.new(init);
+    this.kind = Kind;
+  }
+
+  /**
+   * Checks whether the input is a definition of an user space.
+   */
+  static isWorkspace(input: unknown): boolean {
+    const typed = input as IProject;
+    if (!input || typed.kind !== Kind) {
+      return false;
+    }
+    return true;
+  }
+
+  toJSON(): IProject {
+    const result: IProject = {
+      ...super.toJSON(),
+      kind: Kind,
+    };
+    return result;
+  }
+}

package/src/models/RevisionInfo.ts

@@ -1,3 +1,5 @@
+import { IModification } from './store/Modification.js';
+
 export const Kind = 'Core#Revision';
 
 /**
@@ -34,4 +36,8 @@ export interface IRevisionInfo {
    * The `json8-patch` revisions object used to restore the previous state.
    */
   patch: any[];
+  /**
+   * The modification record for this revision.
+   */
+  modification: IModification;
 }

package/src/models/Thing.ts

@@ -96,7 +96,7 @@ export class Thing {
     const result: IThing = {
       kind: Kind,
     };
-    if (this.name) {
+    if (typeof this.name === 'string') {
       result.name = this.name;
     }
     if (this.description) {

package/src/models/Workspace.ts

@@ -1,5 +1,5 @@
 import { IFile, File, DefaultOwner } from "./store/File.js";
-import { IThing, Thing, Kind as ThingKind } from './Thing.js';
+import { Thing, Kind as ThingKind } from './Thing.js';
 import v4 from '../lib/uuid.js';
 
 export const Kind = 'Core#Space';
@@ -11,18 +11,8 @@ export const Kind = 'Core#Space';
  */
 export interface IWorkspace extends IFile {
   kind: typeof Kind;
-  /**
-   * The space identifier.
-   */
-  key: string;
-  /**
-   * The environment's meta info.
-   */
-  info: IThing;
 }
 
-
-
 /**
  * A definition of the working space for users.
  * 
@@ -31,14 +21,6 @@ export interface IWorkspace extends IFile {
  */
 export class Workspace extends File {
   kind = Kind;
-  /**
-   * The space identifier.
-   */
-  key = '';
-  /**
-   * The name of the environment.
-   */
-  info: Thing = new Thing({ kind: ThingKind });
   
   /**
    * Creates a new Space object from a name.
@@ -57,6 +39,7 @@ export class Workspace extends File {
       parents: [],
       permissionIds: [],
       permissions: [],
+      lastModified: { user: '', time: 0, byMe: false },
     });
     return definition;
   }
@@ -83,6 +66,7 @@ export class Workspace extends File {
         parents: [],
         permissionIds: [],
         permissions: [],
+        lastModified: { user: '', time: 0, byMe: false },
       };
     }
     this.new(init);
@@ -98,14 +82,7 @@ export class Workspace extends File {
       throw new Error(`Not a space.`);
     }
     super.new(init);
-    const { key = v4(), info } = init;
     this.kind = Kind;
-    this.key = key;
-    if (info) {
-      this.info = new Thing(info);
-    } else {
-      this.info = new Thing({ kind: ThingKind, name: '' });
-    }
   }
 
   /**
@@ -121,10 +98,8 @@ export class Workspace extends File {
 
   toJSON(): IWorkspace {
     const result: IWorkspace = {
-      kind: Kind,
-      key: this.key,
-      info: this.info.toJSON(),
       ...super.toJSON(),
+      kind: Kind,
     };
     return result;
   }

package/src/models/store/Deletion.ts

@@ -0,0 +1,24 @@
+/**
+ * A schema describing the delete action performed on an entity.
+ */
+export interface IDeletion {
+  /**
+   * The timestamp of when the entity was deleted.
+   */
+  time: number;
+  /**
+   * The id of the user that has deleted the entity.
+   */
+  user?: string;
+  /**
+   * User name deleting the entity. May not be set when there's no actual user.
+   */
+  name?: string;
+  /**
+   * Whether the deletion was performed by the requesting the data user.
+   * 
+   * Note for store implementers, this field should not be stored and populated every time the 
+   * record is requested.
+   */
+  byMe: boolean;
+}