document-drive 1.0.0-experimental.8 → 1.0.0-websockets

package/CHANGELOG.md

@@ -1,3 +1,151 @@
+# [1.0.0-alpha.75](https://github.com/powerhouse-inc/document-drive/compare/v1.0.0-alpha.74...v1.0.0-alpha.75) (2024-06-18)
+
+
+### Features
+
+* check if operations being added are already stored ([5de4d74](https://github.com/powerhouse-inc/document-drive/commit/5de4d7482e2e6fa60a4e2ca43734771ff501f4d6))
+
+# [1.0.0-alpha.74](https://github.com/powerhouse-inc/document-drive/compare/v1.0.0-alpha.73...v1.0.0-alpha.74) (2024-06-12)
+
+
+### Features
+
+* cleanup listeners when drive is removed ([7c33166](https://github.com/powerhouse-inc/document-drive/commit/7c33166141ee65d7776e5281be0e808bd8936563))
+
+# [1.0.0-alpha.73](https://github.com/powerhouse-inc/document-drive/compare/v1.0.0-alpha.72...v1.0.0-alpha.73) (2024-06-10)
+
+
+### Features
+
+* add storage method to fetch sync units revision ([aa9c16f](https://github.com/powerhouse-inc/document-drive/commit/aa9c16f6b8b90273dc6df007e806274fa2d30f76))
+* implemented getSynchronizationUnitsRevision ([4e8f899](https://github.com/powerhouse-inc/document-drive/commit/4e8f89919d1098dbb4376a9e3be137f581b565d2))
+* removed unnecessary sync units call on pullResponder ([972d2ec](https://github.com/powerhouse-inc/document-drive/commit/972d2ec15cf0f150a4e2b6e88a09e6df6cb7dbc7))
+* removed unnecessary sync units queries ([1c0d98f](https://github.com/powerhouse-inc/document-drive/commit/1c0d98f65dd0e7a52fbb7ad1ad394c256419dc68))
+
+# [1.0.0-alpha.72](https://github.com/powerhouse-inc/document-drive/compare/v1.0.0-alpha.71...v1.0.0-alpha.72) (2024-06-07)
+
+
+### Features
+
+* add sync status to file when add drive operations ([a6c5380](https://github.com/powerhouse-inc/document-drive/commit/a6c5380aafb383c467fc765ee2c2690bdc20cd7c))
+* added sync status to files when add document operations ([c89b02c](https://github.com/powerhouse-inc/document-drive/commit/c89b02c01c3589c725ffa700fbf38812ea700259))
+* remove related sync status when stopSyncRemoteDrive ([c6577e2](https://github.com/powerhouse-inc/document-drive/commit/c6577e2df3846f15248bacbc8b42f358949db3c8))
+* use syncId instead of documentId ([bd4073a](https://github.com/powerhouse-inc/document-drive/commit/bd4073a3d741e03bf99ae9651ef57c5192a1a204))
+
+# [1.0.0-alpha.71](https://github.com/powerhouse-inc/document-drive/compare/v1.0.0-alpha.70...v1.0.0-alpha.71) (2024-06-07)
+
+
+### Features
+
+* added queue actions implementations ([6741a59](https://github.com/powerhouse-inc/document-drive/commit/6741a59d191c5cdd1bfb253c3d5ee28d7f2a0779))
+* support operation and action jobs ([7e6c878](https://github.com/powerhouse-inc/document-drive/commit/7e6c878560ce3132d8dc1a71913a83ad5d138da9))
+
+# [1.0.0-alpha.70](https://github.com/powerhouse-inc/document-drive/compare/v1.0.0-alpha.69...v1.0.0-alpha.70) (2024-06-07)
+
+
+### Bug Fixes
+
+* slug caching ([1465ef0](https://github.com/powerhouse-inc/document-drive/commit/1465ef028d825ed2dfe50126c6dc64e8ba4445d5))
+* slug caching ([1134dc6](https://github.com/powerhouse-inc/document-drive/commit/1134dc6c1384648f6af5c871d0e51e6acb4e63fb))
+
+# [1.0.0-alpha.69](https://github.com/powerhouse-inc/document-drive/compare/v1.0.0-alpha.68...v1.0.0-alpha.69) (2024-06-07)
+
+
+### Bug Fixes
+
+* optimize get documents ([f6f13ab](https://github.com/powerhouse-inc/document-drive/commit/f6f13abb65d8c34a7ba64787fa4ae4ee024956fa))
+
+# [1.0.0-alpha.68](https://github.com/powerhouse-inc/document-drive/compare/v1.0.0-alpha.67...v1.0.0-alpha.68) (2024-06-04)
+
+
+### Bug Fixes
+
+* redis queue ([e99d1b9](https://github.com/powerhouse-inc/document-drive/commit/e99d1b9f0c704836cc0752e36e0f905dc192e5e1))
+
+# [1.0.0-alpha.67](https://github.com/powerhouse-inc/document-drive/compare/v1.0.0-alpha.66...v1.0.0-alpha.67) (2024-06-04)
+
+
+### Features
+
+* get operations from cache on storage ([8416464](https://github.com/powerhouse-inc/document-drive/commit/84164646609045b2cd8e9e8747e364c746d9e3ec))
+
+# [1.0.0-alpha.66](https://github.com/powerhouse-inc/document-drive/compare/v1.0.0-alpha.65...v1.0.0-alpha.66) (2024-06-03)
+
+
+### Features
+
+* updated libs ([5e47758](https://github.com/powerhouse-inc/document-drive/commit/5e477580524a1defd92dd0bef9b160e182436ec9))
+
+# [1.0.0-alpha.65](https://github.com/powerhouse-inc/document-drive/compare/v1.0.0-alpha.64...v1.0.0-alpha.65) (2024-05-30)
+
+
+### Features
+
+* fetch resulting state for last unskipped operation ([8297353](https://github.com/powerhouse-inc/document-drive/commit/8297353dc8eaca107d8134580dee67c3265b05b5))
+
+# [1.0.0-alpha.64](https://github.com/powerhouse-inc/document-drive/compare/v1.0.0-alpha.63...v1.0.0-alpha.64) (2024-05-30)
+
+
+### Features
+
+* update document-model lib version ([#180](https://github.com/powerhouse-inc/document-drive/issues/180)) ([83cec58](https://github.com/powerhouse-inc/document-drive/commit/83cec58cb02388a3b2a643dd5af6c31cd850242d))
+
+# [1.0.0-alpha.63](https://github.com/powerhouse-inc/document-drive/compare/v1.0.0-alpha.62...v1.0.0-alpha.63) (2024-05-30)
+
+
+### Bug Fixes
+
+* operations query ([8dd11c7](https://github.com/powerhouse-inc/document-drive/commit/8dd11c72058452f3e8febac472d01ad56d959e17))
+
+# [1.0.0-alpha.62](https://github.com/powerhouse-inc/document-drive/compare/v1.0.0-alpha.61...v1.0.0-alpha.62) (2024-05-30)
+
+
+### Bug Fixes
+
+* added drive and documentId filter ([718405f](https://github.com/powerhouse-inc/document-drive/commit/718405febbe8e53a3fd392cdd4acf2b041347eaf))
+
+# [1.0.0-alpha.61](https://github.com/powerhouse-inc/document-drive/compare/v1.0.0-alpha.60...v1.0.0-alpha.61) (2024-05-30)
+
+
+### Features
+
+* store resulting state as bytes and only retrieve state for last op of each scope ([c6a5004](https://github.com/powerhouse-inc/document-drive/commit/c6a5004a3dd07ee1ce2f5521bb7a6aa5e970465e))
+
+# [1.0.0-alpha.60](https://github.com/powerhouse-inc/document-drive/compare/v1.0.0-alpha.59...v1.0.0-alpha.60) (2024-05-29)
+
+
+### Features
+
+* avoid duplicated getDocument call ([c0684bc](https://github.com/powerhouse-inc/document-drive/commit/c0684bc0746d8bafb9393cdaeebfb60b38a8a32f))
+
+# [1.0.0-alpha.59](https://github.com/powerhouse-inc/document-drive/compare/v1.0.0-alpha.58...v1.0.0-alpha.59) (2024-05-28)
+
+
+### Features
+
+* enable operation id ([#174](https://github.com/powerhouse-inc/document-drive/issues/174)) ([1d77fd2](https://github.com/powerhouse-inc/document-drive/commit/1d77fd2f6a4618371c6fc4c072d4eab7d27a662a))
+
+# [1.0.0-alpha.58](https://github.com/powerhouse-inc/document-drive/compare/v1.0.0-alpha.57...v1.0.0-alpha.58) (2024-05-28)
+
+
+### Features
+
+* don't save queue job result ([efbf239](https://github.com/powerhouse-inc/document-drive/commit/efbf239e5f77592267446d5c11d670a82f1f6e58))
+
+# [1.0.0-alpha.57](https://github.com/powerhouse-inc/document-drive/compare/v1.0.0-alpha.56...v1.0.0-alpha.57) (2024-05-22)
+
+
+### Features
+
+* new release ([17796e8](https://github.com/powerhouse-inc/document-drive/commit/17796e8577d16d3095a8adf3c40e7bd7146b6142))
+
+# [1.0.0-alpha.56](https://github.com/powerhouse-inc/document-drive/compare/v1.0.0-alpha.55...v1.0.0-alpha.56) (2024-05-22)
+
+
+### Features
+
+* add queues and append only conflict resolution ([d17abd6](https://github.com/powerhouse-inc/document-drive/commit/d17abd664a7381f80faa6530f83ca9e224282ba1)), closes [#153](https://github.com/powerhouse-inc/document-drive/issues/153)
+
 # 1.0.0-experimental.1 (2024-05-15)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "document-drive",
-    "version": "1.0.0-experimental.8",
+    "version": "1.0.0-websockets",
     "license": "AGPL-3.0-only",
     "type": "module",
     "module": "./src/index.ts",
@@ -34,15 +34,18 @@
         "test:watch": "vitest watch"
     },
     "peerDependencies": {
-        "document-model": "1.1.0-experimental.1",
-        "document-model-libs": "^1.37.0"
+        "document-model": "^1.4.0",
+        "document-model-libs": "^1.60.1"
     },
     "optionalDependencies": {
-        "@prisma/client": "5.11.0",
+        "@prisma/client": "5.14.0",
+        "graphql-ws": "^5.16.0",
+        "isomorphic-ws": "^5.0.0",
         "localforage": "^1.10.0",
         "redis": "^4.6.13",
         "sequelize": "^6.35.2",
-        "sqlite3": "^5.1.7"
+        "sqlite3": "^5.1.7",
+        "ws": "^8.17.0"
     },
     "dependencies": {
         "exponential-backoff": "^3.1.1",
@@ -62,11 +65,12 @@
         "@total-typescript/ts-reset": "^0.5.1",
         "@types/node": "^20.12.7",
         "@types/uuid": "^9.0.8",
+        "@types/ws": "^8.5.10",
         "@typescript-eslint/eslint-plugin": "^6.21.0",
         "@typescript-eslint/parser": "^6.21.0",
         "@vitest/coverage-v8": "^1.4.0",
-        "document-model": "1.1.0-experimental.1",
-        "document-model-libs": "1.50.0-arbitrum.1",
+        "document-model": "^1.4.0",
+        "document-model-libs": "^1.60.1",
         "eslint": "^8.57.0",
         "eslint-config-prettier": "^9.1.0",
         "fake-indexeddb": "^5.0.2",
@@ -74,11 +78,12 @@
         "msw": "^2.2.13",
         "prettier": "^3.2.5",
         "prettier-plugin-organize-imports": "^3.2.4",
-        "prisma": "^5.12.1",
+        "prisma": "^5.14.0",
         "semantic-release": "^23.0.8",
         "sequelize": "^6.37.2",
         "sqlite3": "^5.1.7",
         "typescript": "^5.4.4",
-        "vitest": "^1.5.0"
-    }
+        "vitest": "^1.6.0"
+    },
+    "packageManager": "pnpm@9.1.4+sha256.30a1801ac4e723779efed13a21f4c39f9eb6c9fbb4ced101bce06b422593d7c9"
 }

package/src/queue/base.ts

@@ -1,8 +1,7 @@
-import { IJob, IJobQueue, IQueue, IQueueManager, IServerDelegate, JobId, OperationJob, QueueEvents } from "./types";
+import { IJob, IJobQueue, IQueue, IQueueManager, IServerDelegate, JobId, Job, QueueEvents, isOperationJob } from "./types";
 import { generateUUID } from "../utils";
-import { IOperationResult } from "../server";
 import { createNanoEvents, Unsubscribe } from 'nanoevents';
-import { Operation } from "document-model/document";
+import { Action } from "document-model/document";
 import { AddFileInput, DeleteNodeInput } from "document-model-libs/document-drive";
 
 export class MemoryQueue<T, R> implements IQueue<T, R> {
@@ -10,8 +9,7 @@ export class MemoryQueue<T, R> implements IQueue<T, R> {
     private blocked = false;
     private deleted = false;
     private items: IJob<T>[] = [];
-    private results = new Map<JobId, R>();
-    private dependencies = new Array<IJob<OperationJob>>();
+    private dependencies = new Array<IJob<Job>>();
 
     constructor(id: string) {
         this.id = id;
@@ -25,15 +23,6 @@ export class MemoryQueue<T, R> implements IQueue<T, R> {
         return this.deleted;
     }
 
-    async setResult(jobId: string, result: R): Promise<void> {
-        this.results.set(jobId, result);
-        return Promise.resolve();
-    }
-
-    async getResult(jobId: string): Promise<R | undefined> {
-        return Promise.resolve(this.results.get(jobId));
-    }
-
     async addJob(data: IJob<T>) {
         this.items.push(data);
         return Promise.resolve();
@@ -64,7 +53,7 @@ export class MemoryQueue<T, R> implements IQueue<T, R> {
         return this.items;
     }
 
-    async addDependencies(job: IJob<OperationJob>) {
+    async addDependencies(job: IJob<Job>) {
         if (!this.dependencies.find(j => j.jobId === job.jobId)) {
             this.dependencies.push(job);
         }
@@ -73,7 +62,7 @@ export class MemoryQueue<T, R> implements IQueue<T, R> {
         }
     }
 
-    async removeDependencies(job: IJob<OperationJob>) {
+    async removeDependencies(job: IJob<Job>) {
         this.dependencies = this.dependencies.filter((j) => j.jobId !== job.jobId && j.driveId !== job.driveId);
         if (this.dependencies.length === 0) {
             await this.setBlocked(false);
@@ -102,7 +91,7 @@ export class BaseQueueManager implements IQueueManager {
         return Promise.resolve()
     }
 
-    async addJob(job: OperationJob): Promise<JobId> {
+    async addJob(job: Job): Promise<JobId> {
         if (!this.delegate) {
             throw new Error("No server delegate defined");
         }
@@ -125,7 +114,8 @@ export class BaseQueueManager implements IQueueManager {
             const driveQueue = this.getQueue(job.driveId);
             const jobs = await driveQueue.getJobs();
             for (const driveJob of jobs) {
-                const op = driveJob.operations.find((j: Operation) => {
+                const actions = isOperationJob(driveJob) ? driveJob.operations : driveJob.actions;
+                const op = actions.find((j: Action) => {
                     const input = j.input as AddFileInput;
                     return j.type === "ADD_FILE" && input.id === job.documentId
                 })
@@ -137,7 +127,8 @@ export class BaseQueueManager implements IQueueManager {
 
         // if it has ADD_FILE operations then adds the job as
         // a dependency to the corresponding document queues
-        const addFileOps = job.operations.filter((j: Operation) => j.type === "ADD_FILE");
+        const actions = isOperationJob(job) ? job.operations : job.actions;
+        const addFileOps = actions.filter((j: Action) => j.type === "ADD_FILE");
         for (const addFileOp of addFileOps) {
             const input = addFileOp.input as AddFileInput;
             const q = this.getQueue(job.driveId, input.id)
@@ -145,7 +136,7 @@ export class BaseQueueManager implements IQueueManager {
         }
 
         // remove document if operations contains delete_node
-        const removeFileOps = job.operations.filter((j: Operation) => j.type === "DELETE_NODE");
+        const removeFileOps = actions.filter((j: Action) => j.type === "DELETE_NODE");
         for (const removeFileOp of removeFileOps) {
             const input = removeFileOp.input as DeleteNodeInput;
             const queue = this.getQueue(job.driveId, input.id);
@@ -157,11 +148,6 @@ export class BaseQueueManager implements IQueueManager {
         return jobId;
     }
 
-    async getResult(driveId: string, documentId: string, jobId: JobId): Promise<IOperationResult | undefined> {
-        const queue = this.getQueue(driveId, documentId);
-        return queue.getResult(jobId);
-    }
-
     getQueue(driveId: string, documentId?: string) {
         const queueId = this.getQueueId(driveId, documentId);
         let queue = this.queues.find((q) => q.getId() === queueId);
@@ -236,23 +222,22 @@ export class BaseQueueManager implements IQueueManager {
         }
 
         try {
-            const result = await this.delegate.processOperationJob(nextJob);
-            await queue.setResult(nextJob.jobId, result);
+            const result = await this.delegate.processJob(nextJob);
 
             // unblock the document queues of each add_file operation
-            const addFileOperations = nextJob.operations.filter((op) => op.type === "ADD_FILE");
-            if (addFileOperations.length > 0) {
-                addFileOperations.map(async (addFileOp) => {
-                    const documentQueue = this.getQueue(nextJob.driveId, (addFileOp.input as AddFileInput).id);
+            const actions = isOperationJob(nextJob) ? nextJob.operations : nextJob.actions;
+            const addFileActions = actions.filter((op) => op.type === "ADD_FILE");
+            if (addFileActions.length > 0) {
+                for (const addFile of addFileActions) {
+                    const documentQueue = this.getQueue(nextJob.driveId, (addFile.input as AddFileInput).id);
                     await documentQueue.removeDependencies(nextJob);
-                });
+                };
             }
-
             this.emit("jobCompleted", nextJob, result);
         } catch (e) {
             this.emit("jobFailed", nextJob, e as Error);
         } finally {
-            queue.setBlocked(false);
+            await queue.setBlocked(false);
             await this.processNextJob();
         }
     }

package/src/queue/redis.ts

@@ -1,5 +1,5 @@
 import { RedisClientType } from "redis";
-import { IJob, IQueue, IQueueManager, OperationJob } from "./types";
+import { IJob, IQueue, IQueueManager, IServerDelegate, OperationJob } from "./types";
 import { BaseQueueManager } from "./base";
 
 export class RedisQueue<T, R> implements IQueue<T, R> {
@@ -10,18 +10,7 @@ export class RedisQueue<T, R> implements IQueue<T, R> {
         this.client = client;
         this.id = id;
         this.client.hSet("queues", id, "true");
-
-    }
-
-    async setResult(jobId: string, result: any): Promise<void> {
-        await this.client.hSet(this.id + "-results", jobId, JSON.stringify(result));
-    }
-    async getResult(jobId: string): Promise<any> {
-        const results = await this.client.hGet(this.id + "-results", jobId);
-        if (!results) {
-            return null;
-        }
-        return JSON.parse(results);
+        this.client.hSet(this.id, "blocked", "false");
     }
 
     async addJob(data: any) {
@@ -31,9 +20,9 @@ export class RedisQueue<T, R> implements IQueue<T, R> {
     async getNextJob() {
         const job = await this.client.rPop(this.id + "-jobs");
         if (!job) {
-            return null;
+            return undefined;
         }
-        return JSON.parse(job);
+        return JSON.parse(job) as IJob<T>;
     }
 
     async amountOfJobs() {
@@ -44,13 +33,13 @@ export class RedisQueue<T, R> implements IQueue<T, R> {
         if (blocked) {
             await this.client.hSet(this.id, "blocked", "true");
         } else {
-            await this.client.hDel(this.id, "blocked");
+            await this.client.hSet(this.id, "blocked", "false");
         }
     }
 
     async isBlocked() {
         const blockedResult = await this.client.hGet(this.id, "blocked");
-        if (blockedResult) {
+        if (blockedResult === "true") {
             return true;
         }
 
@@ -63,7 +52,7 @@ export class RedisQueue<T, R> implements IQueue<T, R> {
 
     async getJobs() {
         const entries = await this.client.lRange(this.id + "-jobs", 0, -1)
-        return entries.map(e => JSON.parse(e));
+        return entries.map(e => JSON.parse(e) as IJob<T>);
     }
 
     async addDependencies(job: IJob<OperationJob>) {
@@ -80,7 +69,6 @@ export class RedisQueue<T, R> implements IQueue<T, R> {
     }
 
     async removeDependencies(job: IJob<OperationJob>) {
-        const allDeps1 = await this.client.lLen(this.id + "-deps");
         await this.client.lRem(this.id + "-deps", 1, JSON.stringify(job));
         const allDeps = await this.client.lLen(this.id + "-deps");
         if (allDeps > 0) {
@@ -91,15 +79,15 @@ export class RedisQueue<T, R> implements IQueue<T, R> {
     }
 
     async isDeleted() {
-        const deleted = await this.client.hGet(this.id, "deleted");
-        return deleted === "true";
+        const active = await this.client.hGet("queues", this.id);
+        return active === "false";
     }
 
     async setDeleted(deleted: boolean) {
         if (deleted) {
-            await this.client.hSet(this.id, "deleted", "true");
+            await this.client.hSet("queues", this.id, "false");
         } else {
-            await this.client.hDel(this.id, "deleted");
+            await this.client.hSet("queues", this.id, "true");
         }
     }
 }
@@ -115,10 +103,12 @@ export class RedisQueueManager extends BaseQueueManager implements IQueueManager
 
     async init(delegate: IServerDelegate, onError: (error: Error) => void): Promise<void> {
         await super.init(delegate, onError);
-        // load all queues
         const queues = await this.client.hGetAll("queues");
         for (const queueId in queues) {
-            this.queues.push(new RedisQueue(queueId, this.client));
+            const active = await this.client.hGet("queues", queueId);
+            if (active === "true") {
+                this.queues.push(new RedisQueue(queueId, this.client));
+            }
         }
     }
 

package/src/queue/types.ts

@@ -1,32 +1,42 @@
-import { Operation } from "document-model/document";
+import { Action, Operation } from "document-model/document";
 import { IOperationResult } from "../server";
 import type { Unsubscribe } from "nanoevents";
 
-export type OperationJob = {
+export interface BaseJob {
     driveId: string;
     documentId?: string
-    operations: Operation[]
+    actions?: Action[]
     forceSync?: boolean
 }
 
+export interface OperationJob extends BaseJob {
+    operations: Operation[]
+}
+
+export interface ActionJob extends BaseJob {
+    actions: Action[]
+}
+
+export type Job = OperationJob | ActionJob;
+
 export type JobId = string;
 
 export interface QueueEvents {
-    jobCompleted: (job: IJob<OperationJob>, result: IOperationResult) => void;
-    jobFailed: (job: IJob<OperationJob>, error: Error) => void;
+    jobCompleted: (job: IJob<Job>, result: IOperationResult) => void;
+    jobFailed: (job: IJob<Job>, error: Error) => void;
+    queueRemoved: (queueId: string) => void;
 }
 
 export interface IServerDelegate {
     checkDocumentExists: (driveId: string, documentId: string) => Promise<boolean>;
-    processOperationJob: (job: OperationJob) => Promise<IOperationResult>;
-}
+    processJob: (job: Job) => Promise<IOperationResult>;
+};
 
 export interface IQueueManager {
-    addJob(job: OperationJob): Promise<JobId>;
-    getResult(driveId: string, documentId: string, jobId: JobId): Promise<IOperationResult | undefined>;
-    getQueue(driveId: string, document?: string): IQueue<OperationJob, IOperationResult>;
+    addJob(job: Job): Promise<JobId>;
+    getQueue(driveId: string, document?: string): IQueue<Job, IOperationResult>;
     removeQueue(driveId: string, documentId?: string): void;
-    getQueueByIndex(index: number): IQueue<OperationJob, IOperationResult> | null;
+    getQueueByIndex(index: number): IQueue<Job, IOperationResult> | null;
     getQueues(): string[];
     init(delegate: IServerDelegate, onError: (error: Error) => void): Promise<void>;
     on<K extends keyof QueueEvents>(
@@ -47,11 +57,17 @@ export interface IQueue<T, R> {
     isBlocked(): Promise<boolean>;
     isDeleted(): Promise<boolean>;
     setDeleted(deleted: boolean): Promise<void>;
-    setResult(jobId: JobId, result: R): Promise<void>;
-    getResult(jobId: JobId): Promise<R | undefined>;
     getJobs(): Promise<IJob<T>[]>;
-    addDependencies(job: IJob<OperationJob>): Promise<void>;
-    removeDependencies(job: IJob<OperationJob>): Promise<void>;
+    addDependencies(job: IJob<Job>): Promise<void>;
+    removeDependencies(job: IJob<Job>): Promise<void>;
+}
+
+export type IJobQueue = IQueue<Job, IOperationResult>;
+
+export function isOperationJob(job: Job): job is OperationJob {
+    return "operations" in job;
 }
 
-export type IJobQueue = IQueue<OperationJob, IOperationResult>;
+export function isActionJob(job: Job): job is ActionJob {
+    return "actions" in job;
+}