@enbox/dwn-sdk-js 0.0.1

package/dist/esm/src/core/protocols-grant-authorization.js

@@ -0,0 +1,66 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { GrantAuthorization } from './grant-authorization.js';
+import { DwnError, DwnErrorCode } from './dwn-error.js';
+export class ProtocolsGrantAuthorization {
+    /**
+     * Authorizes the given ProtocolsConfigure in the scope of the DID given.
+     */
+    static authorizeConfigure(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { protocolsConfigureMessage, expectedGrantor, expectedGrantee, permissionGrant, messageStore } = input;
+            yield GrantAuthorization.performBaseValidation({
+                incomingMessage: protocolsConfigureMessage,
+                expectedGrantor,
+                expectedGrantee,
+                permissionGrant,
+                messageStore
+            });
+            ProtocolsGrantAuthorization.verifyScope(protocolsConfigureMessage, permissionGrant.scope);
+        });
+    }
+    /**
+     * Authorizes the scope of a permission grant for a ProtocolsQuery message.
+     * @param messageStore Used to check if the grant has been revoked.
+     */
+    static authorizeQuery(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const { expectedGrantee, expectedGrantor, incomingMessage, permissionGrant, messageStore } = input;
+            yield GrantAuthorization.performBaseValidation({
+                incomingMessage: incomingMessage,
+                expectedGrantor,
+                expectedGrantee,
+                permissionGrant,
+                messageStore
+            });
+            // If the grant specifies a protocol, the query must specify the same protocol.
+            const permissionScope = permissionGrant.scope;
+            const protocolInGrant = permissionScope.protocol;
+            const protocolInMessage = (_a = incomingMessage.descriptor.filter) === null || _a === void 0 ? void 0 : _a.protocol;
+            if (protocolInGrant !== undefined && protocolInMessage !== protocolInGrant) {
+                throw new DwnError(DwnErrorCode.ProtocolsGrantAuthorizationQueryProtocolScopeMismatch, `Grant protocol scope ${protocolInGrant} does not match protocol in message ${protocolInMessage}`);
+            }
+        });
+    }
+    /**
+     * Verifies a ProtocolsConfigure against the scope of the given grant.
+     */
+    static verifyScope(protocolsConfigureMessage, grantScope) {
+        // if the grant scope does not specify a protocol, then it is am unrestricted grant
+        if (grantScope.protocol === undefined) {
+            return;
+        }
+        if (grantScope.protocol !== protocolsConfigureMessage.descriptor.definition.protocol) {
+            throw new DwnError(DwnErrorCode.ProtocolsGrantAuthorizationScopeProtocolMismatch, `Grant scope specifies different protocol than what appears in the configure message.`);
+        }
+    }
+}
+//# sourceMappingURL=protocols-grant-authorization.js.map

package/dist/esm/src/core/protocols-grant-authorization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocols-grant-authorization.js","sourceRoot":"","sources":["../../../../src/core/protocols-grant-authorization.ts"],"names":[],"mappings":";;;;;;;;;AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,OAAO,2BAA2B;IACtC;;OAEG;IACI,MAAM,CAAO,kBAAkB,CAAC,KAMtC;;YACC,MAAM,EACJ,yBAAyB,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAC3F,GAAG,KAAK,CAAC;YAEV,MAAM,kBAAkB,CAAC,qBAAqB,CAAC;gBAC7C,eAAe,EAAE,yBAAyB;gBAC1C,eAAe;gBACf,eAAe;gBACf,eAAe;gBACf,YAAY;aACb,CAAC,CAAC;YAEH,2BAA2B,CAAC,WAAW,CAAC,yBAAyB,EAAE,eAAe,CAAC,KAAgC,CAAC,CAAC;QACvH,CAAC;KAAA;IAED;;;OAGG;IACI,MAAM,CAAO,cAAc,CAAC,KAMlC;;;YACC,MAAM,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC;YAEnG,MAAM,kBAAkB,CAAC,qBAAqB,CAAC;gBAC7C,eAAe,EAAE,eAAe;gBAChC,eAAe;gBACf,eAAe;gBACf,eAAe;gBACf,YAAY;aACb,CAAC,CAAC;YAEH,+EAA+E;YAC/E,MAAM,eAAe,GAAG,eAAe,CAAC,KAAgC,CAAC;YACzE,MAAM,eAAe,GAAG,eAAe,CAAC,QAAQ,CAAC;YACjD,MAAM,iBAAiB,GAAG,MAAA,eAAe,CAAC,UAAU,CAAC,MAAM,0CAAE,QAAQ,CAAC;YACtE,IAAI,eAAe,KAAK,SAAS,IAAI,iBAAiB,KAAK,eAAe,EAAE,CAAC;gBAC3E,MAAM,IAAI,QAAQ,CAChB,YAAY,CAAC,qDAAqD,EAClE,wBAAwB,eAAe,uCAAuC,iBAAiB,EAAE,CAClG,CAAC;YACJ,CAAC;QACH,CAAC;KAAA;IAED;;OAEG;IACK,MAAM,CAAC,WAAW,CACxB,yBAAoD,EACpD,UAAmC;QAGnC,mFAAmF;QACnF,IAAI,UAAU,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACtC,OAAO;QACT,CAAC;QAED,IAAI,UAAU,CAAC,QAAQ,KAAK,yBAAyB,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YACrF,MAAM,IAAI,QAAQ,CAChB,YAAY,CAAC,gDAAgD,EAC7D,sFAAsF,CACvF,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/esm/src/core/records-grant-authorization.js

@@ -0,0 +1,132 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { GrantAuthorization } from './grant-authorization.js';
+import { PermissionConditionPublication } from '../types/permission-types.js';
+import { DwnError, DwnErrorCode } from './dwn-error.js';
+export class RecordsGrantAuthorization {
+    /**
+     * Authorizes the given RecordsWrite in the scope of the DID given.
+     */
+    static authorizeWrite(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { recordsWriteMessage, expectedGrantor, expectedGrantee, permissionGrant, messageStore } = input;
+            yield GrantAuthorization.performBaseValidation({
+                incomingMessage: recordsWriteMessage,
+                expectedGrantor,
+                expectedGrantee,
+                permissionGrant,
+                messageStore
+            });
+            // NOTE: validated the invoked permission is for Records in GrantAuthorization.performBaseValidation()
+            RecordsGrantAuthorization.verifyScope(recordsWriteMessage, permissionGrant.scope);
+            RecordsGrantAuthorization.verifyConditions(recordsWriteMessage, permissionGrant.conditions);
+        });
+    }
+    /**
+     * Authorizes a RecordsReadMessage using the given permission grant.
+     * @param messageStore Used to check if the given grant has been revoked.
+     */
+    static authorizeRead(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { recordsReadMessage, recordsWriteMessageToBeRead, expectedGrantor, expectedGrantee, permissionGrant, messageStore } = input;
+            yield GrantAuthorization.performBaseValidation({
+                incomingMessage: recordsReadMessage,
+                expectedGrantor,
+                expectedGrantee,
+                permissionGrant,
+                messageStore
+            });
+            // NOTE: validated the invoked permission is for Records in GrantAuthorization.performBaseValidation()
+            RecordsGrantAuthorization.verifyScope(recordsWriteMessageToBeRead, permissionGrant.scope);
+        });
+    }
+    /**
+     * Authorizes the scope of a permission grant for RecordsQuery or RecordsSubscribe.
+     * @param messageStore Used to check if the grant has been revoked.
+     */
+    static authorizeQueryOrSubscribe(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { incomingMessage, expectedGrantor, expectedGrantee, permissionGrant, messageStore } = input;
+            yield GrantAuthorization.performBaseValidation({
+                incomingMessage,
+                expectedGrantor,
+                expectedGrantee,
+                permissionGrant,
+                messageStore
+            });
+            // If the grant specifies a protocol, the subscribe or query must specify the same protocol.
+            // NOTE: validated the invoked permission is for Records in GrantAuthorization.performBaseValidation()
+            const permissionScope = permissionGrant.scope;
+            const protocolInGrant = permissionScope.protocol;
+            const protocolInMessage = incomingMessage.descriptor.filter.protocol;
+            if (protocolInGrant !== undefined && protocolInMessage !== protocolInGrant) {
+                throw new DwnError(DwnErrorCode.RecordsGrantAuthorizationQueryOrSubscribeProtocolScopeMismatch, `Grant protocol scope ${protocolInGrant} does not match protocol in message ${protocolInMessage}`);
+            }
+        });
+    }
+    /**
+     * Authorizes the scope of a permission grant for RecordsDelete.
+     * @param messageStore Used to check if the grant has been revoked.
+     */
+    static authorizeDelete(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { recordsDeleteMessage, recordsWriteToDelete, expectedGrantor, expectedGrantee, permissionGrant, messageStore } = input;
+            yield GrantAuthorization.performBaseValidation({
+                incomingMessage: recordsDeleteMessage,
+                expectedGrantor,
+                expectedGrantee,
+                permissionGrant,
+                messageStore
+            });
+            // If the grant specifies a protocol, the delete must be deleting a record with the same protocol.
+            // NOTE: validated the invoked permission is for Records in GrantAuthorization.performBaseValidation()
+            const permissionScope = permissionGrant.scope;
+            const protocolInGrant = permissionScope.protocol;
+            const protocolOfRecordToDelete = recordsWriteToDelete.descriptor.protocol;
+            if (protocolInGrant !== undefined && protocolOfRecordToDelete !== protocolInGrant) {
+                throw new DwnError(DwnErrorCode.RecordsGrantAuthorizationDeleteProtocolScopeMismatch, `Grant protocol scope ${protocolInGrant} does not match protocol in record to delete ${protocolOfRecordToDelete}`);
+            }
+        });
+    }
+    /**
+     * Verifies a record against the scope of the given grant.
+     */
+    static verifyScope(recordsWriteMessage, grantScope) {
+        // The record's protocol must match the protocol specified in the record
+        if (grantScope.protocol !== recordsWriteMessage.descriptor.protocol) {
+            throw new DwnError(DwnErrorCode.RecordsGrantAuthorizationScopeProtocolMismatch, `Grant scope specifies different protocol than what appears in the record`);
+        }
+        // If grant specifies a contextId, check that record falls under that contextId
+        if (grantScope.contextId !== undefined) {
+            if (recordsWriteMessage.contextId === undefined || !recordsWriteMessage.contextId.startsWith(grantScope.contextId)) {
+                throw new DwnError(DwnErrorCode.RecordsGrantAuthorizationScopeContextIdMismatch, `Grant scope specifies different contextId than what appears in the record`);
+            }
+        }
+        // If grant specifies protocolPath, check that record is at that protocolPath
+        if (grantScope.protocolPath !== undefined && grantScope.protocolPath !== recordsWriteMessage.descriptor.protocolPath) {
+            throw new DwnError(DwnErrorCode.RecordsGrantAuthorizationScopeProtocolPathMismatch, `Grant scope specifies different protocolPath than what appears in the record`);
+        }
+    }
+    /**
+     * Verifies grant `conditions`.
+     * Currently the only condition is `published` which only applies to RecordsWrites
+     */
+    static verifyConditions(recordsWriteMessage, conditions) {
+        // If conditions require publication, RecordsWrite must have `published` === true
+        if ((conditions === null || conditions === void 0 ? void 0 : conditions.publication) === PermissionConditionPublication.Required && !recordsWriteMessage.descriptor.published) {
+            throw new DwnError(DwnErrorCode.RecordsGrantAuthorizationConditionPublicationRequired, 'Permission grant requires message to be published');
+        }
+        // if conditions prohibit publication, RecordsWrite must have published === false or undefined
+        if ((conditions === null || conditions === void 0 ? void 0 : conditions.publication) === PermissionConditionPublication.Prohibited && recordsWriteMessage.descriptor.published) {
+            throw new DwnError(DwnErrorCode.RecordsGrantAuthorizationConditionPublicationProhibited, 'Permission grant prohibits message from being published');
+        }
+    }
+}
+//# sourceMappingURL=records-grant-authorization.js.map

package/dist/esm/src/core/records-grant-authorization.js.map

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

package/dist/esm/src/core/resumable-task-manager.js

@@ -0,0 +1,109 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+export var ResumableTaskName;
+(function (ResumableTaskName) {
+    ResumableTaskName["RecordsDelete"] = "RecordsDelete";
+})(ResumableTaskName || (ResumableTaskName = {}));
+export class ResumableTaskManager {
+    constructor(resumableTaskStore, storageController) {
+        this.resumableTaskStore = resumableTaskStore;
+        this.resumableTaskBatchSize = 100;
+        // assign resumable task handlers
+        this.resumableTaskHandlers = {
+            // NOTE: The arrow function is IMPORTANT here, else the `this` context will be lost within the invoked method.
+            // e.g. code within performRecordsDelete() won't know `this` refers to the `storageController` instance.
+            [ResumableTaskName.RecordsDelete]: (task) => __awaiter(this, void 0, void 0, function* () { return yield storageController.performRecordsDelete(task); }),
+        };
+    }
+    /**
+     * Runs a new resumable task.
+     */
+    run(task) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const timeoutInSeconds = ResumableTaskManager.timeoutExtensionFrequencyInSeconds * 2; // give ample time for extension to take place
+            // register the new resumable task before running it so that it can be resumed if it times out for any reason
+            const managedResumableTask = yield this.resumableTaskStore.register(task, timeoutInSeconds);
+            yield this.runWithAutomaticTimeoutExtension(managedResumableTask);
+        });
+    }
+    /**
+     * Runs a resumable task with automatic timeout extension.
+     * Deletes the task from the resumable task store once it is completed.
+     */
+    runWithAutomaticTimeoutExtension(managedTask) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const timeoutInSeconds = ResumableTaskManager.timeoutExtensionFrequencyInSeconds * 2; // give ample time for extension to take place
+            let timer;
+            try {
+                // start a timer loop to keep extending the timeout of the task until it is completed
+                timer = setInterval(() => {
+                    this.resumableTaskStore.extend(managedTask.id, timeoutInSeconds);
+                }, ResumableTaskManager.timeoutExtensionFrequencyInSeconds * 1000);
+                const handler = this.resumableTaskHandlers[managedTask.task.name];
+                yield handler(managedTask.task.data);
+                yield this.resumableTaskStore.delete(managedTask.id);
+            }
+            finally {
+                ResumableTaskManager.clearTimeoutExtensionTimer(timer);
+            }
+        });
+    }
+    /**
+     * Removes the specified timeout extension loop timer.
+     * NOTE: created mainly for testing purposes so we can spy on this specific method without needing to filter out other `clearInterval` calls.
+     * NOTE: using `ReturnType` utility type to avoid using node.js specific type, because `setInterval` returns a `number` in browser environments.
+     */
+    static clearTimeoutExtensionTimer(timer) {
+        clearInterval(timer);
+    }
+    /**
+     * Resumes the execution of resumable tasks until all are completed successfully.
+     */
+    resumeTasksAndWaitForCompletion() {
+        return __awaiter(this, void 0, void 0, function* () {
+            while (true) {
+                const resumableTasks = yield this.resumableTaskStore.grab(this.resumableTaskBatchSize);
+                if (resumableTasks === undefined || resumableTasks.length === 0) {
+                    break;
+                }
+                // Handle this batch of tasks before grabbing the next batch.
+                yield this.retryTasksUntilCompletion(resumableTasks);
+            }
+        });
+    }
+    /**
+     * Repeatedly retry the given tasks until all are completed successfully.
+     */
+    retryTasksUntilCompletion(resumableTasks) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let managedTasks = resumableTasks;
+            while (managedTasks.length > 0) {
+                const managedTasksCopy = managedTasks;
+                managedTasks = [];
+                const allTaskPromises = managedTasksCopy.map((managedTask) => __awaiter(this, void 0, void 0, function* () {
+                    try {
+                        yield this.runWithAutomaticTimeoutExtension(managedTask);
+                    }
+                    catch (error) {
+                        console.error('Error while running resumable task:', error);
+                        console.error('Resumable task:', resumableTasks);
+                        managedTasks.push(managedTask);
+                    }
+                }));
+                yield Promise.all(allTaskPromises);
+            }
+        });
+    }
+}
+/**
+ * The frequency at which the automatic timeout extension is requested for a resumable task.
+ */
+ResumableTaskManager.timeoutExtensionFrequencyInSeconds = 30;
+//# sourceMappingURL=resumable-task-manager.js.map

package/dist/esm/src/core/resumable-task-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resumable-task-manager.js","sourceRoot":"","sources":["../../../../src/core/resumable-task-manager.ts"],"names":[],"mappings":";;;;;;;;;AAGA,MAAM,CAAN,IAAY,iBAEX;AAFD,WAAY,iBAAiB;IAC3B,oDAA+B,CAAA;AACjC,CAAC,EAFW,iBAAiB,KAAjB,iBAAiB,QAE5B;AAQD,MAAM,OAAO,oBAAoB;IAU/B,YAA2B,kBAAsC,EAAE,iBAAoC;QAA5E,uBAAkB,GAAlB,kBAAkB,CAAoB;QAHzD,2BAAsB,GAAG,GAAG,CAAC;QAInC,iCAAiC;QACjC,IAAI,CAAC,qBAAqB,GAAG;YAC3B,8GAA8G;YAC9G,wGAAwG;YACxG,CAAC,iBAAiB,CAAC,aAAa,CAAC,EAAE,CAAO,IAAI,EAAiB,EAAE,gDAAC,OAAA,MAAM,iBAAiB,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAA,GAAA;SACrH,CAAC;IACJ,CAAC;IAED;;OAEG;IACU,GAAG,CAAC,IAAmB;;YAClC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,kCAAkC,GAAG,CAAC,CAAC,CAAC,8CAA8C;YAEpI,6GAA6G;YAC7G,MAAM,oBAAoB,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;YAC5F,MAAM,IAAI,CAAC,gCAAgC,CAAC,oBAAoB,CAAC,CAAC;QACpE,CAAC;KAAA;IAED;;;OAGG;IACW,gCAAgC,CAAC,WAAiC;;YAC9E,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,kCAAkC,GAAG,CAAC,CAAC,CAAC,8CAA8C;YAEpI,IAAI,KAAsC,CAAC;YAC3C,IAAI,CAAC;gBACH,qFAAqF;gBACrF,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;oBACvB,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;gBACnE,CAAC,EAAE,oBAAoB,CAAC,kCAAkC,GAAG,IAAI,CAAC,CAAC;gBAEnE,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClE,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrC,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YACvD,CAAC;oBAAS,CAAC;gBACT,oBAAoB,CAAC,0BAA0B,CAAC,KAAK,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;KAAA;IAED;;;;OAIG;IACI,MAAM,CAAC,0BAA0B,CAAC,KAAqC;QAC5E,aAAa,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED;;OAEG;IACU,+BAA+B;;YAC1C,OAAO,IAAI,EAAE,CAAC;gBACZ,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;gBAEvF,IAAI,cAAc,KAAK,SAAS,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAChE,MAAM;gBACR,CAAC;gBAED,6DAA6D;gBAC7D,MAAM,IAAI,CAAC,yBAAyB,CAAC,cAAc,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;KAAA;IAED;;OAEG;IACW,yBAAyB,CAAC,cAAsC;;YAE5E,IAAI,YAAY,GAAG,cAAc,CAAC;YAClC,OAAO,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,gBAAgB,GAAG,YAAY,CAAC;gBACtC,YAAY,GAAG,EAAE,CAAC;gBAElB,MAAM,eAAe,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAO,WAAW,EAAE,EAAE;oBACjE,IAAI,CAAC;wBACH,MAAM,IAAI,CAAC,gCAAgC,CAAC,WAAW,CAAC,CAAC;oBAC3D,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAAC;wBAC5D,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE,cAAc,CAAC,CAAC;wBACjD,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;oBACjC,CAAC;gBACH,CAAC,CAAA,CAAC,CAAC;gBAEH,MAAM,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;KAAA;;AAjGD;;GAEG;AACoB,uDAAkC,GAAG,EAAE,AAAL,CAAM"}

package/dist/esm/src/core/tenant-gate.js

@@ -0,0 +1,20 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+/**
+ * A tenant gate that treats every DID as an active tenant.
+ */
+export class AllowAllTenantGate {
+    isActiveTenant(_did) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return { isActiveTenant: true };
+        });
+    }
+}
+//# sourceMappingURL=tenant-gate.js.map

package/dist/esm/src/core/tenant-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-gate.js","sourceRoot":"","sources":["../../../../src/core/tenant-gate.ts"],"names":[],"mappings":";;;;;;;;;AAyBA;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAChB,cAAc,CAAC,IAAY;;YACtC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;QAClC,CAAC;KAAA;CACF"}

package/dist/esm/src/dwn.js

@@ -0,0 +1,164 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { AllowAllTenantGate } from './core/tenant-gate.js';
+import { Message } from './core/message.js';
+import { messageReplyFromError } from './core/message-reply.js';
+import { MessagesQueryHandler } from './handlers/messages-query.js';
+import { MessagesReadHandler } from './handlers/messages-read.js';
+import { MessagesSubscribeHandler } from './handlers/messages-subscribe.js';
+import { ProtocolsConfigureHandler } from './handlers/protocols-configure.js';
+import { ProtocolsQueryHandler } from './handlers/protocols-query.js';
+import { RecordsDeleteHandler } from './handlers/records-delete.js';
+import { RecordsQueryHandler } from './handlers/records-query.js';
+import { RecordsReadHandler } from './handlers/records-read.js';
+import { RecordsSubscribeHandler } from './handlers/records-subscribe.js';
+import { RecordsWriteHandler } from './handlers/records-write.js';
+import { ResumableTaskManager } from './core/resumable-task-manager.js';
+import { StorageController } from './store/storage-controller.js';
+import { DidDht, DidJwk, DidKey, DidResolverCacheLevel, DidWeb, UniversalResolver } from '@enbox/dids';
+import { DwnInterfaceName, DwnMethodName } from './enums/dwn-interface-method.js';
+export class Dwn {
+    constructor(config) {
+        this.didResolver = config.didResolver;
+        this.tenantGate = config.tenantGate;
+        this.eventStream = config.eventStream;
+        this.messageStore = config.messageStore;
+        this.dataStore = config.dataStore;
+        this.resumableTaskStore = config.resumableTaskStore;
+        this.eventLog = config.eventLog;
+        this.eventStream = config.eventStream;
+        this.storageController = new StorageController({
+            messageStore: this.messageStore,
+            dataStore: this.dataStore,
+            eventLog: this.eventLog,
+            eventStream: this.eventStream
+        });
+        this.resumableTaskManager = new ResumableTaskManager(config.resumableTaskStore, this.storageController);
+        this.methodHandlers = {
+            [DwnInterfaceName.Messages + DwnMethodName.Query]: new MessagesQueryHandler(this.didResolver, this.messageStore, this.eventLog),
+            [DwnInterfaceName.Messages + DwnMethodName.Read]: new MessagesReadHandler(this.didResolver, this.messageStore, this.dataStore),
+            [DwnInterfaceName.Messages + DwnMethodName.Subscribe]: new MessagesSubscribeHandler(this.didResolver, this.messageStore, this.eventStream),
+            [DwnInterfaceName.Protocols + DwnMethodName.Configure]: new ProtocolsConfigureHandler(this.didResolver, this.messageStore, this.eventLog, this.eventStream),
+            [DwnInterfaceName.Protocols + DwnMethodName.Query]: new ProtocolsQueryHandler(this.didResolver, this.messageStore, this.dataStore),
+            [DwnInterfaceName.Records + DwnMethodName.Delete]: new RecordsDeleteHandler(this.didResolver, this.messageStore, this.resumableTaskManager),
+            [DwnInterfaceName.Records + DwnMethodName.Query]: new RecordsQueryHandler(this.didResolver, this.messageStore, this.dataStore),
+            [DwnInterfaceName.Records + DwnMethodName.Read]: new RecordsReadHandler(this.didResolver, this.messageStore, this.dataStore),
+            [DwnInterfaceName.Records + DwnMethodName.Subscribe]: new RecordsSubscribeHandler(this.didResolver, this.messageStore, this.eventStream),
+            [DwnInterfaceName.Records + DwnMethodName.Write]: new RecordsWriteHandler(this.didResolver, this.messageStore, this.dataStore, this.eventLog, this.eventStream)
+        };
+    }
+    /**
+     * Creates an instance of the DWN.
+     */
+    static create(config) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            (_a = config.didResolver) !== null && _a !== void 0 ? _a : (config.didResolver = new UniversalResolver({
+                didResolvers: [DidDht, DidJwk, DidKey, DidWeb],
+                cache: new DidResolverCacheLevel({ location: 'RESOLVERCACHE' }),
+            }));
+            (_b = config.tenantGate) !== null && _b !== void 0 ? _b : (config.tenantGate = new AllowAllTenantGate());
+            const dwn = new Dwn(config);
+            yield dwn.open();
+            return dwn;
+        });
+    }
+    /**
+     * Initializes the DWN instance and opens the connection to it.
+     */
+    open() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            yield this.messageStore.open();
+            yield this.dataStore.open();
+            yield this.resumableTaskStore.open();
+            yield this.eventLog.open();
+            yield ((_a = this.eventStream) === null || _a === void 0 ? void 0 : _a.open());
+            yield this.resumableTaskManager.resumeTasksAndWaitForCompletion();
+        });
+    }
+    close() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            yield ((_a = this.eventStream) === null || _a === void 0 ? void 0 : _a.close());
+            yield this.messageStore.close();
+            yield this.dataStore.close();
+            yield this.resumableTaskStore.close();
+            yield this.eventLog.close();
+        });
+    }
+    processMessage(tenant_1, rawMessage_1) {
+        return __awaiter(this, arguments, void 0, function* (tenant, rawMessage, options = {}) {
+            var _a;
+            const errorMessageReply = (_a = yield this.validateTenant(tenant)) !== null && _a !== void 0 ? _a : yield this.validateMessageIntegrity(rawMessage);
+            if (errorMessageReply !== undefined) {
+                return errorMessageReply;
+            }
+            const { dataStream, subscriptionHandler } = options;
+            const handlerKey = rawMessage.descriptor.interface + rawMessage.descriptor.method;
+            const methodHandlerReply = yield this.methodHandlers[handlerKey].handle({
+                tenant,
+                message: rawMessage,
+                dataStream,
+                subscriptionHandler
+            });
+            return methodHandlerReply;
+        });
+    }
+    /**
+     * Checks tenant gate to see if tenant is allowed.
+     * @param tenant The tenant DID to route the given message to.
+     * @returns GenericMessageReply if the message has an integrity error, otherwise undefined.
+     */
+    validateTenant(tenant) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const result = yield this.tenantGate.isActiveTenant(tenant);
+            if (!result.isActiveTenant) {
+                const detail = (_a = result.detail) !== null && _a !== void 0 ? _a : `DID ${tenant} is not an active tenant.`;
+                return {
+                    status: { code: 401, detail }
+                };
+            }
+        });
+    }
+    /**
+     * Validates structure of DWN message
+     * @param tenant The tenant DID to route the given message to.
+     * @param dwnMessageInterface The interface of DWN message.
+     * @param dwnMessageMethod The interface of DWN message.
+  
+     * @returns GenericMessageReply if the message has an integrity error, otherwise undefined.
+     */
+    validateMessageIntegrity(rawMessage) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            // Verify interface and method
+            const dwnInterface = (_a = rawMessage === null || rawMessage === void 0 ? void 0 : rawMessage.descriptor) === null || _a === void 0 ? void 0 : _a.interface;
+            const dwnMethod = (_b = rawMessage === null || rawMessage === void 0 ? void 0 : rawMessage.descriptor) === null || _b === void 0 ? void 0 : _b.method;
+            if (dwnInterface === undefined || dwnMethod === undefined) {
+                return {
+                    status: { code: 400, detail: `Both interface and method must be present, interface: ${dwnInterface}, method: ${dwnMethod}` }
+                };
+            }
+            // validate message structure
+            try {
+                // consider to push this down to individual handlers
+                Message.validateJsonSchema(rawMessage);
+            }
+            catch (error) {
+                return messageReplyFromError(error, 400);
+            }
+        });
+    }
+}
+;
+;
+//# sourceMappingURL=dwn.js.map

package/dist/esm/src/dwn.js.map

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

package/dist/esm/src/enums/dwn-interface-method.js

@@ -0,0 +1,16 @@
+export var DwnInterfaceName;
+(function (DwnInterfaceName) {
+    DwnInterfaceName["Messages"] = "Messages";
+    DwnInterfaceName["Protocols"] = "Protocols";
+    DwnInterfaceName["Records"] = "Records";
+})(DwnInterfaceName || (DwnInterfaceName = {}));
+export var DwnMethodName;
+(function (DwnMethodName) {
+    DwnMethodName["Configure"] = "Configure";
+    DwnMethodName["Query"] = "Query";
+    DwnMethodName["Read"] = "Read";
+    DwnMethodName["Write"] = "Write";
+    DwnMethodName["Delete"] = "Delete";
+    DwnMethodName["Subscribe"] = "Subscribe";
+})(DwnMethodName || (DwnMethodName = {}));
+//# sourceMappingURL=dwn-interface-method.js.map

package/dist/esm/src/enums/dwn-interface-method.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dwn-interface-method.js","sourceRoot":"","sources":["../../../../src/enums/dwn-interface-method.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,gBAIX;AAJD,WAAY,gBAAgB;IAC1B,yCAAqB,CAAA;IACrB,2CAAuB,CAAA;IACvB,uCAAmB,CAAA;AACrB,CAAC,EAJW,gBAAgB,KAAhB,gBAAgB,QAI3B;AAED,MAAM,CAAN,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,wCAAuB,CAAA;IACvB,gCAAe,CAAA;IACf,8BAAa,CAAA;IACb,gCAAe,CAAA;IACf,kCAAiB,CAAA;IACjB,wCAAuB,CAAA;AACzB,CAAC,EAPW,aAAa,KAAb,aAAa,QAOxB"}

package/dist/esm/src/event-log/event-emitter-stream.js

@@ -0,0 +1,60 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { EventEmitter } from 'events';
+import { DwnError, DwnErrorCode } from '../core/dwn-error.js';
+const EVENTS_LISTENER_CHANNEL = 'events';
+;
+export class EventEmitterStream {
+    constructor(config = {}) {
+        this.isOpen = false;
+        /**
+         * we subscribe to the `EventEmitter` error handler with a provided handler or set one which logs the errors.
+         */
+        this.errorHandler = (error) => { console.error('event emitter error', error); };
+        // we capture the rejections and currently just log the errors that are produced
+        this.eventEmitter = new EventEmitter({ captureRejections: true });
+        // number of listeners per particular eventName before a warning is emitted
+        // we set to 0 which represents infinity.
+        // https://nodejs.org/api/events.html#emittersetmaxlistenersn
+        this.eventEmitter.setMaxListeners(0);
+        if (config.errorHandler) {
+            this.errorHandler = config.errorHandler;
+        }
+        this.eventEmitter.on('error', this.errorHandler);
+    }
+    subscribe(tenant, id, listener) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.eventEmitter.on(`${tenant}_${EVENTS_LISTENER_CHANNEL}`, listener);
+            return {
+                id,
+                close: () => __awaiter(this, void 0, void 0, function* () { this.eventEmitter.off(`${tenant}_${EVENTS_LISTENER_CHANNEL}`, listener); })
+            };
+        });
+    }
+    open() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.isOpen = true;
+        });
+    }
+    close() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.isOpen = false;
+            this.eventEmitter.removeAllListeners();
+        });
+    }
+    emit(tenant, event, indexes) {
+        if (!this.isOpen) {
+            this.errorHandler(new DwnError(DwnErrorCode.EventEmitterStreamNotOpenError, 'a message emitted when EventEmitterStream is closed'));
+            return;
+        }
+        this.eventEmitter.emit(`${tenant}_${EVENTS_LISTENER_CHANNEL}`, tenant, event, indexes);
+    }
+}
+//# sourceMappingURL=event-emitter-stream.js.map

package/dist/esm/src/event-log/event-emitter-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter-stream.js","sourceRoot":"","sources":["../../../../src/event-log/event-emitter-stream.ts"],"names":[],"mappings":";;;;;;;;;AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAE9D,MAAM,uBAAuB,GAAG,QAAQ,CAAC;AAQxC,CAAC;AAEF,MAAM,OAAO,kBAAkB;IAI7B,YAAY,SAAmC,EAAE;QAFzC,WAAM,GAAY,KAAK,CAAC;QAkBhC;;WAEG;QACK,iBAAY,GAAwB,CAAC,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAlBtG,gFAAgF;QAChF,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;QAElE,2EAA2E;QAC3E,yCAAyC;QACzC,6DAA6D;QAC7D,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAErC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QAC1C,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACnD,CAAC;IAOK,SAAS,CAAC,MAAc,EAAE,EAAU,EAAE,QAAuB;;YACjE,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,MAAM,IAAI,uBAAuB,EAAE,EAAE,QAAQ,CAAC,CAAC;YACvE,OAAO;gBACL,EAAE;gBACF,KAAK,EAAE,GAAwB,EAAE,gDAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,uBAAuB,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;aAC/G,CAAC;QACJ,CAAC;KAAA;IAEK,IAAI;;YACR,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;KAAA;IAEK,KAAK;;YACT,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;YACpB,IAAI,CAAC,YAAY,CAAC,kBAAkB,EAAE,CAAC;QACzC,CAAC;KAAA;IAED,IAAI,CAAC,MAAc,EAAE,KAAmB,EAAE,OAAkB;QAC1D,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,YAAY,CAAC,IAAI,QAAQ,CAC5B,YAAY,CAAC,8BAA8B,EAC3C,qDAAqD,CACtD,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,uBAAuB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACzF,CAAC;CACF"}