@twin.org/immutable-proof-service 0.0.1-next.7 → 0.0.1-next.8

package/dist/cjs/index.cjs

@@ -4,13 +4,14 @@ var core = require('@twin.org/core');
 var immutableProofModels = require('@twin.org/immutable-proof-models');
 var standardsW3cDid = require('@twin.org/standards-w3c-did');
 var web = require('@twin.org/web');
+var backgroundTaskModels = require('@twin.org/background-task-models');
 var crypto = require('@twin.org/crypto');
 var dataJsonLd = require('@twin.org/data-json-ld');
-var entity = require('@twin.org/entity');
 var entityStorageModels = require('@twin.org/entity-storage-models');
 var identityModels = require('@twin.org/identity-models');
 var immutableStorageModels = require('@twin.org/immutable-storage-models');
 var vaultModels = require('@twin.org/vault-models');
+var entity = require('@twin.org/entity');
 
 /**
  * The source used when communicating about these routes.
@@ -329,6 +330,11 @@ class ImmutableProofService {
      * @internal
      */
     _immutableStorage;
+    /**
+     * The background task connector.
+     * @internal
+     */
+    _backgroundTaskConnector;
     /**
      * The assertion method id to use for the proofs.
      * @internal
@@ -339,11 +345,6 @@ class ImmutableProofService {
      * @internal
      */
     _proofHashKeyId;
-    /**
-     * Are we currently processing proofs.
-     * @internal
-     */
-    _processing;
     /**
      * Create a new instance of ImmutableProofService.
      * @param options The dependencies for the immutable proof connector.
@@ -352,16 +353,18 @@ class ImmutableProofService {
      * @param options.immutableProofEntityStorageType The entity storage for proofs, defaults to "immutable-proof".
      * @param options.immutableStorageType The immutable storage, defaults to "immutable-storage".
      * @param options.identityConnectorType The identity connector type, defaults to "identity".
+     * @param options.backgroundTaskConnectorType The background task connector type, defaults to "background-task".
      */
     constructor(options) {
         this._vaultConnector = vaultModels.VaultConnectorFactory.get(options?.vaultConnectorType ?? "vault");
         this._proofStorage = entityStorageModels.EntityStorageConnectorFactory.get(options?.immutableProofEntityStorageType ?? core.StringHelper.kebabCase("ImmutableProof"));
         this._immutableStorage = immutableStorageModels.ImmutableStorageConnectorFactory.get(options?.immutableStorageType ?? "immutable-storage");
         this._identityConnector = identityModels.IdentityConnectorFactory.get(options?.identityConnectorType ?? "identity");
+        this._backgroundTaskConnector = backgroundTaskModels.BackgroundTaskConnectorFactory.get(options?.backgroundTaskConnectorType ?? "background-task");
         this._config = options?.config ?? {};
         this._assertionMethodId = this._config.assertionMethodId ?? "immutable-proof-assertion";
         this._proofHashKeyId = this._config.proofHashKeyId ?? "immutable-proof-hash";
-        this._processing = false;
+        this._backgroundTaskConnector.registerHandler("immutable-proof", async (proof) => this.processProof(proof));
     }
     /**
      * Create a new authentication proof.
@@ -391,7 +394,7 @@ class ImmutableProofService {
                 proofObjectHash: core.Converter.bytesToBase64(hash)
             };
             await this._proofStorage.set(proofEntity);
-            this.startProcessingProofs(0);
+            await this._backgroundTaskConnector.create("immutable-proof", proofEntity);
             return new core.Urn(ImmutableProofService.NAMESPACE, id).toString();
         }
         catch (error) {
@@ -517,66 +520,26 @@ class ImmutableProofService {
         return model;
     }
     /**
-     * Start processing proofs.
-     * @param interval The interval to process proofs.
-     * @returns Nothing.
+     * Process a proof.
+     * @param proofEntity The proof entity to process.
      * @internal
      */
-    startProcessingProofs(interval) {
-        if (!this._processing) {
-            this._processing = true;
-            setTimeout(async () => {
-                await this.processProofs();
-            }, interval);
-        }
-    }
-    /**
-     * Process the proofs.
-     * @internal
-     */
-    async processProofs() {
-        let remainingProofs = 0;
-        try {
-            // Get the oldest pending proof, plus one more, we can then determine whether to
-            // trigger another process after this one
-            const pendingProofs = await this._proofStorage.query({
-                property: "immutableStorageId",
-                comparison: entity.ComparisonOperator.Equals,
-                value: undefined
-            }, [
-                {
-                    property: "dateCreated",
-                    sortDirection: entity.SortDirection.Ascending
-                }
-            ], undefined, undefined, 2);
-            remainingProofs = pendingProofs.entities.length;
-            if (remainingProofs > 0) {
-                const proofEntity = pendingProofs.entities[0];
-                const immutableProof = this.proofEntityToJsonLd(proofEntity);
-                const hashData = await this.generateHashData(proofEntity.nodeIdentity, immutableProof);
-                // As we are adding the proof to the data we update its context
-                immutableProof["@context"] = [
-                    immutableProofModels.ImmutableProofTypes.ContextRoot,
-                    standardsW3cDid.DidContexts.ContextVCDataIntegrity
-                ];
-                immutableProof.proof = await this._identityConnector.createProof(proofEntity.nodeIdentity, `${proofEntity.nodeIdentity}#${this._assertionMethodId}`, hashData);
-                if (core.Is.stringValue(immutableProof.proof.created)) {
-                    proofEntity.dateCreated = immutableProof.proof.created;
-                }
-                const compacted = await dataJsonLd.JsonLdProcessor.compact(immutableProof, immutableProof["@context"]);
-                const immutableStoreResult = await this._immutableStorage.store(proofEntity.nodeIdentity, core.ObjectHelper.toBytes(compacted));
-                proofEntity.immutableStorageId = immutableStoreResult.id;
-                await this._proofStorage.set(proofEntity);
-                remainingProofs--;
-            }
-        }
-        finally {
-            // If there are still remaining proofs, start the timer again
-            this._processing = false;
-            if (remainingProofs > 0) {
-                this.startProcessingProofs(100);
-            }
+    async processProof(proofEntity) {
+        const immutableProof = this.proofEntityToJsonLd(proofEntity);
+        const hashData = await this.generateHashData(proofEntity.nodeIdentity, immutableProof);
+        // As we are adding the proof to the data we update its context
+        immutableProof["@context"] = [
+            immutableProofModels.ImmutableProofTypes.ContextRoot,
+            standardsW3cDid.DidContexts.ContextVCDataIntegrity
+        ];
+        immutableProof.proof = await this._identityConnector.createProof(proofEntity.nodeIdentity, `${proofEntity.nodeIdentity}#${this._assertionMethodId}`, hashData);
+        if (core.Is.stringValue(immutableProof.proof.created)) {
+            proofEntity.dateCreated = immutableProof.proof.created;
         }
+        const compacted = await dataJsonLd.JsonLdProcessor.compact(immutableProof, immutableProof["@context"]);
+        const immutableStoreResult = await this._immutableStorage.store(proofEntity.nodeIdentity, core.ObjectHelper.toBytes(compacted));
+        proofEntity.immutableStorageId = immutableStoreResult.id;
+        await this._proofStorage.set(proofEntity);
     }
     /**
      * Verify an authentication proof.

package/dist/esm/index.mjs

@@ -2,13 +2,14 @@ import { Guards, ComponentFactory, StringHelper, Validation, Converter, RandomHe
 import { ImmutableProofTypes, ImmutableProofFailure } from '@twin.org/immutable-proof-models';
 import { DidContexts, DidTypes, DidCryptoSuites } from '@twin.org/standards-w3c-did';
 import { HttpStatusCode, HeaderTypes, MimeTypes } from '@twin.org/web';
+import { BackgroundTaskConnectorFactory } from '@twin.org/background-task-models';
 import { Blake2b, Sha256 } from '@twin.org/crypto';
 import { JsonLdHelper, JsonLdProcessor } from '@twin.org/data-json-ld';
-import { ComparisonOperator, SortDirection, property, entity, EntitySchemaFactory, EntitySchemaHelper } from '@twin.org/entity';
 import { EntityStorageConnectorFactory } from '@twin.org/entity-storage-models';
 import { IdentityConnectorFactory } from '@twin.org/identity-models';
 import { ImmutableStorageConnectorFactory, ImmutableStorageTypes } from '@twin.org/immutable-storage-models';
 import { VaultConnectorFactory } from '@twin.org/vault-models';
+import { property, SortDirection, entity, EntitySchemaFactory, EntitySchemaHelper } from '@twin.org/entity';
 
 /**
  * The source used when communicating about these routes.
@@ -327,6 +328,11 @@ class ImmutableProofService {
      * @internal
      */
     _immutableStorage;
+    /**
+     * The background task connector.
+     * @internal
+     */
+    _backgroundTaskConnector;
     /**
      * The assertion method id to use for the proofs.
      * @internal
@@ -337,11 +343,6 @@ class ImmutableProofService {
      * @internal
      */
     _proofHashKeyId;
-    /**
-     * Are we currently processing proofs.
-     * @internal
-     */
-    _processing;
     /**
      * Create a new instance of ImmutableProofService.
      * @param options The dependencies for the immutable proof connector.
@@ -350,16 +351,18 @@ class ImmutableProofService {
      * @param options.immutableProofEntityStorageType The entity storage for proofs, defaults to "immutable-proof".
      * @param options.immutableStorageType The immutable storage, defaults to "immutable-storage".
      * @param options.identityConnectorType The identity connector type, defaults to "identity".
+     * @param options.backgroundTaskConnectorType The background task connector type, defaults to "background-task".
      */
     constructor(options) {
         this._vaultConnector = VaultConnectorFactory.get(options?.vaultConnectorType ?? "vault");
         this._proofStorage = EntityStorageConnectorFactory.get(options?.immutableProofEntityStorageType ?? StringHelper.kebabCase("ImmutableProof"));
         this._immutableStorage = ImmutableStorageConnectorFactory.get(options?.immutableStorageType ?? "immutable-storage");
         this._identityConnector = IdentityConnectorFactory.get(options?.identityConnectorType ?? "identity");
+        this._backgroundTaskConnector = BackgroundTaskConnectorFactory.get(options?.backgroundTaskConnectorType ?? "background-task");
         this._config = options?.config ?? {};
         this._assertionMethodId = this._config.assertionMethodId ?? "immutable-proof-assertion";
         this._proofHashKeyId = this._config.proofHashKeyId ?? "immutable-proof-hash";
-        this._processing = false;
+        this._backgroundTaskConnector.registerHandler("immutable-proof", async (proof) => this.processProof(proof));
     }
     /**
      * Create a new authentication proof.
@@ -389,7 +392,7 @@ class ImmutableProofService {
                 proofObjectHash: Converter.bytesToBase64(hash)
             };
             await this._proofStorage.set(proofEntity);
-            this.startProcessingProofs(0);
+            await this._backgroundTaskConnector.create("immutable-proof", proofEntity);
             return new Urn(ImmutableProofService.NAMESPACE, id).toString();
         }
         catch (error) {
@@ -515,66 +518,26 @@ class ImmutableProofService {
         return model;
     }
     /**
-     * Start processing proofs.
-     * @param interval The interval to process proofs.
-     * @returns Nothing.
+     * Process a proof.
+     * @param proofEntity The proof entity to process.
      * @internal
      */
-    startProcessingProofs(interval) {
-        if (!this._processing) {
-            this._processing = true;
-            setTimeout(async () => {
-                await this.processProofs();
-            }, interval);
-        }
-    }
-    /**
-     * Process the proofs.
-     * @internal
-     */
-    async processProofs() {
-        let remainingProofs = 0;
-        try {
-            // Get the oldest pending proof, plus one more, we can then determine whether to
-            // trigger another process after this one
-            const pendingProofs = await this._proofStorage.query({
-                property: "immutableStorageId",
-                comparison: ComparisonOperator.Equals,
-                value: undefined
-            }, [
-                {
-                    property: "dateCreated",
-                    sortDirection: SortDirection.Ascending
-                }
-            ], undefined, undefined, 2);
-            remainingProofs = pendingProofs.entities.length;
-            if (remainingProofs > 0) {
-                const proofEntity = pendingProofs.entities[0];
-                const immutableProof = this.proofEntityToJsonLd(proofEntity);
-                const hashData = await this.generateHashData(proofEntity.nodeIdentity, immutableProof);
-                // As we are adding the proof to the data we update its context
-                immutableProof["@context"] = [
-                    ImmutableProofTypes.ContextRoot,
-                    DidContexts.ContextVCDataIntegrity
-                ];
-                immutableProof.proof = await this._identityConnector.createProof(proofEntity.nodeIdentity, `${proofEntity.nodeIdentity}#${this._assertionMethodId}`, hashData);
-                if (Is.stringValue(immutableProof.proof.created)) {
-                    proofEntity.dateCreated = immutableProof.proof.created;
-                }
-                const compacted = await JsonLdProcessor.compact(immutableProof, immutableProof["@context"]);
-                const immutableStoreResult = await this._immutableStorage.store(proofEntity.nodeIdentity, ObjectHelper.toBytes(compacted));
-                proofEntity.immutableStorageId = immutableStoreResult.id;
-                await this._proofStorage.set(proofEntity);
-                remainingProofs--;
-            }
-        }
-        finally {
-            // If there are still remaining proofs, start the timer again
-            this._processing = false;
-            if (remainingProofs > 0) {
-                this.startProcessingProofs(100);
-            }
+    async processProof(proofEntity) {
+        const immutableProof = this.proofEntityToJsonLd(proofEntity);
+        const hashData = await this.generateHashData(proofEntity.nodeIdentity, immutableProof);
+        // As we are adding the proof to the data we update its context
+        immutableProof["@context"] = [
+            ImmutableProofTypes.ContextRoot,
+            DidContexts.ContextVCDataIntegrity
+        ];
+        immutableProof.proof = await this._identityConnector.createProof(proofEntity.nodeIdentity, `${proofEntity.nodeIdentity}#${this._assertionMethodId}`, hashData);
+        if (Is.stringValue(immutableProof.proof.created)) {
+            proofEntity.dateCreated = immutableProof.proof.created;
         }
+        const compacted = await JsonLdProcessor.compact(immutableProof, immutableProof["@context"]);
+        const immutableStoreResult = await this._immutableStorage.store(proofEntity.nodeIdentity, ObjectHelper.toBytes(compacted));
+        proofEntity.immutableStorageId = immutableStoreResult.id;
+        await this._proofStorage.set(proofEntity);
     }
     /**
      * Verify an authentication proof.

package/dist/types/immutableProofService.d.ts

@@ -21,13 +21,15 @@ export declare class ImmutableProofService implements IImmutableProofComponent {
      * @param options.immutableProofEntityStorageType The entity storage for proofs, defaults to "immutable-proof".
      * @param options.immutableStorageType The immutable storage, defaults to "immutable-storage".
      * @param options.identityConnectorType The identity connector type, defaults to "identity".
+     * @param options.backgroundTaskConnectorType The background task connector type, defaults to "background-task".
      */
     constructor(options?: {
         vaultConnectorType?: string;
         immutableProofEntityStorageType?: string;
         immutableStorageType?: string;
-        config?: IImmutableProofServiceConfig;
         identityConnectorType?: string;
+        backgroundTaskConnectorType?: string;
+        config?: IImmutableProofServiceConfig;
     });
     /**
      * Create a new authentication proof.

package/docs/changelog.md

@@ -1,5 +1,5 @@
 # @twin.org/immutable-proof-service - Changelog
 
-## v0.0.1-next.7
+## v0.0.1-next.8
 
 - Initial Release

package/docs/reference/classes/ImmutableProofService.md

@@ -32,14 +32,18 @@ The entity storage for proofs, defaults to "immutable-proof".
 
 The immutable storage, defaults to "immutable-storage".
 
-• **options.config?**: [`IImmutableProofServiceConfig`](../interfaces/IImmutableProofServiceConfig.md)
-
-The configuration for the connector.
-
 • **options.identityConnectorType?**: `string`
 
 The identity connector type, defaults to "identity".
 
+• **options.backgroundTaskConnectorType?**: `string`
+
+The background task connector type, defaults to "background-task".
+
+• **options.config?**: [`IImmutableProofServiceConfig`](../interfaces/IImmutableProofServiceConfig.md)
+
+The configuration for the connector.
+
 #### Returns
 
 [`ImmutableProofService`](ImmutableProofService.md)

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/immutable-proof-service",
-	"version": "0.0.1-next.7",
+	"version": "0.0.1-next.8",
 	"description": "Immutable proof contract implementation and REST endpoint definitions",
 	"repository": {
 		"type": "git",
@@ -15,6 +15,7 @@
 	},
 	"dependencies": {
 		"@twin.org/api-models": "next",
+		"@twin.org/background-task-models": "next",
 		"@twin.org/core": "next",
 		"@twin.org/crypto": "next",
 		"@twin.org/data-json-ld": "next",
@@ -22,7 +23,7 @@
 		"@twin.org/entity": "next",
 		"@twin.org/entity-storage-models": "next",
 		"@twin.org/identity-models": "next",
-		"@twin.org/immutable-proof-models": "0.0.1-next.7",
+		"@twin.org/immutable-proof-models": "0.0.1-next.8",
 		"@twin.org/immutable-storage-models": "next",
 		"@twin.org/nameof": "next",
 		"@twin.org/standards-w3c-did": "next",