@twin.org/entity-storage-connector-dynamodb 0.0.2-next.1 → 0.0.2-next.10

package/README.md

@@ -13,7 +13,7 @@ npm install @twin.org/entity-storage-connector-dynamodb
 The tests developed are functional tests and need an instance of DynamoDB up and running. To run DynamoDB locally:
 
 ```sh
-docker run -p 8000:8000 --name twin-entity-storage-dynamodb --hostname dynamodb -d amazon/dynamodb-local
+docker run -p 8500:8000 --name twin-entity-storage-dynamodb --hostname dynamodb -d amazon/dynamodb-local
 ```
 
 Afterwards you can run the tests as follows:

package/dist/cjs/index.cjs

@@ -5,7 +5,6 @@ var libDynamodb = require('@aws-sdk/lib-dynamodb');
 var utilDynamodb = require('@aws-sdk/util-dynamodb');
 var core = require('@twin.org/core');
 var entity = require('@twin.org/entity');
-var loggingModels = require('@twin.org/logging-models');
 
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
@@ -13,11 +12,15 @@ var loggingModels = require('@twin.org/logging-models');
  * Class for performing entity storage operations using Dynamo DB.
  */
 class DynamoDbEntityStorageConnector {
+    /**
+     * Runtime name for the class.
+     */
+    static CLASS_NAME = "DynamoDbEntityStorageConnector";
     /**
      * Limit the number of entities when finding.
      * @internal
      */
-    static _PAGE_SIZE = 40;
+    static _DEFAULT_LIMIT = 40;
     /**
      * Partition id field name.
      * @internal
@@ -28,10 +31,6 @@ class DynamoDbEntityStorageConnector {
      * @internal
      */
     static _PARTITION_ID_VALUE = "1";
-    /**
-     * Runtime name for the class.
-     */
-    CLASS_NAME = "DynamoDbEntityStorageConnector";
     /**
      * The schema for the entity.
      * @internal
@@ -52,13 +51,16 @@ class DynamoDbEntityStorageConnector {
      * @param options The options for the connector.
      */
     constructor(options) {
-        core.Guards.object(this.CLASS_NAME, "options", options);
-        core.Guards.stringValue(this.CLASS_NAME, "options.entitySchema", options.entitySchema);
-        core.Guards.object(this.CLASS_NAME, "options.config", options.config);
-        core.Guards.stringValue(this.CLASS_NAME, "options.config.accessKeyId", options.config.accessKeyId);
-        core.Guards.stringValue(this.CLASS_NAME, "options.config.secretAccessKey", options.config.secretAccessKey);
-        core.Guards.stringValue(this.CLASS_NAME, "options.config.region", options.config.region);
-        core.Guards.stringValue(this.CLASS_NAME, "options.config.tableName", options.config.tableName);
+        core.Guards.object(DynamoDbEntityStorageConnector.CLASS_NAME, "options", options);
+        core.Guards.stringValue(DynamoDbEntityStorageConnector.CLASS_NAME, "options.entitySchema", options.entitySchema);
+        core.Guards.object(DynamoDbEntityStorageConnector.CLASS_NAME, "options.config", options.config);
+        options.config.authMode ??= "credentials";
+        if (options.config.authMode === "credentials") {
+            core.Guards.stringValue(DynamoDbEntityStorageConnector.CLASS_NAME, "options.config.accessKeyId", options.config.accessKeyId);
+            core.Guards.stringValue(DynamoDbEntityStorageConnector.CLASS_NAME, "options.config.secretAccessKey", options.config.secretAccessKey);
+        }
+        core.Guards.stringValue(DynamoDbEntityStorageConnector.CLASS_NAME, "options.config.region", options.config.region);
+        core.Guards.stringValue(DynamoDbEntityStorageConnector.CLASS_NAME, "options.config.tableName", options.config.tableName);
         this._entitySchema = entity.EntitySchemaFactory.get(options.entitySchema);
         this._primaryKey = entity.EntitySchemaHelper.getPrimaryKey(this._entitySchema);
         this._config = options.config;
@@ -68,15 +70,15 @@ class DynamoDbEntityStorageConnector {
     }
     /**
      * Bootstrap the component by creating and initializing any resources it needs.
-     * @param nodeLoggingConnectorType The node logging connector type, defaults to "node-logging".
+     * @param nodeLoggingComponentType The node logging component type.
      * @returns True if the bootstrapping process was successful.
      */
-    async bootstrap(nodeLoggingConnectorType) {
-        const nodeLogging = loggingModels.LoggingConnectorFactory.getIfExists(nodeLoggingConnectorType ?? "node-logging");
+    async bootstrap(nodeLoggingComponentType) {
+        const nodeLogging = core.ComponentFactory.getIfExists(nodeLoggingComponentType);
         if (!(await this.tableExists(this._config.tableName))) {
             await nodeLogging?.log({
                 level: "info",
-                source: this.CLASS_NAME,
+                source: DynamoDbEntityStorageConnector.CLASS_NAME,
                 ts: Date.now(),
                 message: "tableCreating",
                 data: {
@@ -160,7 +162,7 @@ class DynamoDbEntityStorageConnector {
                 });
                 await nodeLogging?.log({
                     level: "info",
-                    source: this.CLASS_NAME,
+                    source: DynamoDbEntityStorageConnector.CLASS_NAME,
                     ts: Date.now(),
                     message: "tableCreated",
                     data: {
@@ -172,7 +174,7 @@ class DynamoDbEntityStorageConnector {
                 if (core.BaseError.isErrorCode(err, "ResourceInUseException")) {
                     await nodeLogging?.log({
                         level: "info",
-                        source: this.CLASS_NAME,
+                        source: DynamoDbEntityStorageConnector.CLASS_NAME,
                         ts: Date.now(),
                         message: "tableExists",
                         data: {
@@ -181,19 +183,16 @@ class DynamoDbEntityStorageConnector {
                     });
                 }
                 else {
-                    const errors = err instanceof AggregateError ? err.errors : [err];
-                    for (const error of errors) {
-                        await nodeLogging?.log({
-                            level: "error",
-                            source: this.CLASS_NAME,
-                            ts: Date.now(),
-                            message: "tableCreateFailed",
-                            error: core.BaseError.fromError(error),
-                            data: {
-                                tableName: this._config.tableName
-                            }
-                        });
-                    }
+                    await nodeLogging?.log({
+                        level: "error",
+                        source: DynamoDbEntityStorageConnector.CLASS_NAME,
+                        ts: Date.now(),
+                        message: "tableCreateFailed",
+                        error: core.BaseError.fromError(err),
+                        data: {
+                            tableName: this._config.tableName
+                        }
+                    });
                 }
                 return false;
             }
@@ -201,7 +200,7 @@ class DynamoDbEntityStorageConnector {
         else {
             await nodeLogging?.log({
                 level: "info",
-                source: this.CLASS_NAME,
+                source: DynamoDbEntityStorageConnector.CLASS_NAME,
                 ts: Date.now(),
                 message: "tableExists",
                 data: {
@@ -226,7 +225,7 @@ class DynamoDbEntityStorageConnector {
      * @returns The object if it can be found or undefined.
      */
     async get(id, secondaryIndex, conditions) {
-        core.Guards.stringValue(this.CLASS_NAME, "id", id);
+        core.Guards.stringValue(DynamoDbEntityStorageConnector.CLASS_NAME, "id", id);
         try {
             const docClient = this.createDocClient();
             if (core.Is.empty(secondaryIndex) && core.Is.empty(conditions)) {
@@ -265,11 +264,11 @@ class DynamoDbEntityStorageConnector {
         }
         catch (err) {
             if (core.BaseError.isErrorCode(err, "ResourceNotFoundException")) {
-                throw new core.GeneralError(this.CLASS_NAME, "tableDoesNotExist", {
-                    table: this._config.tableName
+                throw new core.GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "tableDoesNotExist", {
+                    tableName: this._config.tableName
                 }, err);
             }
-            throw new core.GeneralError(this.CLASS_NAME, "getFailed", {
+            throw new core.GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "getFailed", {
                 id
             }, err);
         }
@@ -281,7 +280,7 @@ class DynamoDbEntityStorageConnector {
      * @returns The id of the entity.
      */
     async set(entity$1, conditions) {
-        core.Guards.object(this.CLASS_NAME, "entity", entity$1);
+        core.Guards.object(DynamoDbEntityStorageConnector.CLASS_NAME, "entity", entity$1);
         entity.EntitySchemaHelper.validateEntity(entity$1, this.getSchema());
         const id = entity$1[this._primaryKey.property];
         try {
@@ -308,11 +307,11 @@ class DynamoDbEntityStorageConnector {
                 return;
             }
             if (core.BaseError.isErrorCode(err, "ResourceNotFoundException")) {
-                throw new core.GeneralError(this.CLASS_NAME, "tableDoesNotExist", {
+                throw new core.GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "tableDoesNotExist", {
                     tableName: this._config.tableName
                 }, err);
             }
-            throw new core.GeneralError(this.CLASS_NAME, "setFailed", {
+            throw new core.GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "setFailed", {
                 id
             }, err);
         }
@@ -324,7 +323,7 @@ class DynamoDbEntityStorageConnector {
      * @returns Nothing.
      */
     async remove(id, conditions) {
-        core.Guards.stringValue(this.CLASS_NAME, "id", id);
+        core.Guards.stringValue(DynamoDbEntityStorageConnector.CLASS_NAME, "id", id);
         try {
             const docClient = this.createDocClient();
             const { conditionExpression, attributeNames, attributeValues } = this.buildConditionExpression(conditions);
@@ -345,11 +344,11 @@ class DynamoDbEntityStorageConnector {
                 return;
             }
             if (core.BaseError.isErrorCode(err, "ResourceNotFoundException")) {
-                throw new core.GeneralError(this.CLASS_NAME, "tableDoesNotExist", {
-                    table: this._config.tableName
+                throw new core.GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "tableDoesNotExist", {
+                    tableName: this._config.tableName
                 }, err);
             }
-            throw new core.GeneralError(this.CLASS_NAME, "removeFailed", {
+            throw new core.GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "removeFailed", {
                 id
             }, err);
         }
@@ -359,13 +358,13 @@ class DynamoDbEntityStorageConnector {
      * @param conditions The conditions to match for the entities.
      * @param sortProperties The optional sort order.
      * @param properties The optional properties to return, defaults to all.
-     * @param cursor The cursor to request the next page of entities.
-     * @param pageSize The suggested number of entities to return in each chunk, in some scenarios can return a different amount.
+     * @param cursor The cursor to request the next chunk of entities.
+     * @param limit The suggested number of entities to return in each chunk, in some scenarios can return a different amount.
      * @returns All the entities for the storage matching the conditions,
      * and a cursor which can be used to request more entities.
      */
-    async query(conditions, sortProperties, properties, cursor, pageSize) {
-        return this.internalQuery(conditions, sortProperties, properties, cursor, pageSize);
+    async query(conditions, sortProperties, properties, cursor, limit) {
+        return this.internalQuery(conditions, sortProperties, properties, cursor, limit);
     }
     /**
      * Delete the table.
@@ -421,7 +420,7 @@ class DynamoDbEntityStorageConnector {
         const schemaProp = this._entitySchema.properties?.find(p => p.property === condition.property);
         // It's a single value so just create the property comparison for the condition
         const comparison = this.mapComparisonOperator(objectPath, condition, schemaProp?.type, attributeNames, attributeValues);
-        const isKey = schemaProp?.isPrimary || (schemaProp?.isSecondary && schemaProp?.property === secondaryIndex);
+        const isKey = schemaProp?.isPrimary ?? (schemaProp?.isSecondary && schemaProp?.property === secondaryIndex);
         return {
             keyCondition: isKey ? comparison : "",
             filterCondition: !isKey ? comparison : ""
@@ -495,7 +494,7 @@ class DynamoDbEntityStorageConnector {
         else if (comparator.comparison === entity.ComparisonOperator.In) {
             return `${propName} IN ${attributeName}`;
         }
-        throw new core.GeneralError(this.CLASS_NAME, "comparisonNotSupported", {
+        throw new core.GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "comparisonNotSupported", {
             comparison: comparator.comparison
         });
     }
@@ -532,7 +531,9 @@ class DynamoDbEntityStorageConnector {
         else if (operator === entity.LogicalOperator.Or) {
             return "OR";
         }
-        throw new core.GeneralError(this.CLASS_NAME, "conditionalNotSupported", { operator });
+        throw new core.GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "conditionalNotSupported", {
+            operator
+        });
     }
     /**
      * Format a value to insert into DB.
@@ -588,11 +589,19 @@ class DynamoDbEntityStorageConnector {
      * @internal
      */
     createConnectionConfig() {
+        if (core.Is.stringValue(this._config.secretAccessKey) &&
+            core.Is.stringValue(this._config.accessKeyId) &&
+            this._config.authMode === "credentials") {
+            return {
+                credentials: {
+                    accessKeyId: this._config.accessKeyId,
+                    secretAccessKey: this._config.secretAccessKey
+                },
+                endpoint: this._config.endpoint,
+                region: this._config.region
+            };
+        }
         return {
-            credentials: {
-                accessKeyId: this._config.accessKeyId,
-                secretAccessKey: this._config.secretAccessKey
-            },
             endpoint: this._config.endpoint,
             region: this._config.region
         };
@@ -618,16 +627,16 @@ class DynamoDbEntityStorageConnector {
      * @param conditions The conditions to match for the entities.
      * @param sortProperties The optional sort order.
      * @param properties The optional properties to return, defaults to all.
-     * @param cursor The cursor to request the next page of entities.
-     * @param pageSize The suggested number of entities to return in each chunk, in some scenarios can return a different amount.
+     * @param cursor The cursor to request the next chunk of entities.
+     * @param limit The suggested number of entities to return in each chunk, in some scenarios can return a different amount.
      * @param secondaryIndex The secondary index to use for the query.
      * @returns All the entities for the storage matching the conditions,
      * and a cursor which can be used to request more entities.
      * @internal
      */
-    async internalQuery(conditions, sortProperties, properties, cursor, pageSize, secondaryIndex) {
+    async internalQuery(conditions, sortProperties, properties, cursor, limit, secondaryIndex) {
         try {
-            const returnSize = pageSize ?? DynamoDbEntityStorageConnector._PAGE_SIZE;
+            const returnSize = limit ?? DynamoDbEntityStorageConnector._DEFAULT_LIMIT;
             let indexName = core.Is.stringValue(secondaryIndex)
                 ? `${secondaryIndex}Index`
                 : undefined;
@@ -636,7 +645,7 @@ class DynamoDbEntityStorageConnector {
             let scanAscending = true;
             if (core.Is.arrayValue(sortProperties)) {
                 if (sortProperties.length > 1) {
-                    throw new core.GeneralError(this.CLASS_NAME, "sortSingle");
+                    throw new core.GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "sortSingle");
                 }
                 for (const sortProperty of sortProperties) {
                     const propertySchema = this._entitySchema.properties?.find(e => e.property === sortProperty.property);
@@ -644,7 +653,7 @@ class DynamoDbEntityStorageConnector {
                         (!propertySchema.isPrimary &&
                             !propertySchema.isSecondary &&
                             core.Is.empty(propertySchema.sortDirection))) {
-                        throw new core.GeneralError(this.CLASS_NAME, "sortNotIndexed", {
+                        throw new core.GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "sortNotIndexed", {
                             property: sortProperty.property
                         });
                     }
@@ -700,11 +709,11 @@ class DynamoDbEntityStorageConnector {
         }
         catch (err) {
             if (core.BaseError.isErrorCode(err, "ResourceNotFoundException")) {
-                throw new core.GeneralError(this.CLASS_NAME, "tableDoesNotExist", {
-                    table: this._config.tableName
+                throw new core.GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "tableDoesNotExist", {
+                    tableName: this._config.tableName
                 }, err);
             }
-            throw new core.GeneralError(this.CLASS_NAME, "queryFailed", undefined, err);
+            throw new core.GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "queryFailed", undefined, err);
         }
     }
     /**
@@ -723,7 +732,7 @@ class DynamoDbEntityStorageConnector {
             for (const c of conditions) {
                 const schemaProp = this._entitySchema.properties?.find(p => p.property === c.property);
                 if (core.Is.undefined(schemaProp)) {
-                    throw new core.GeneralError(this.CLASS_NAME, "propertyNotFound", {
+                    throw new core.GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "propertyNotFound", {
                         property: c.property
                     });
                 }

package/dist/esm/index.mjs

@@ -1,9 +1,8 @@
 import { waitUntilTableExists, DynamoDB, QueryCommand } from '@aws-sdk/client-dynamodb';
 import { GetCommand, PutCommand, DeleteCommand, DynamoDBDocumentClient } from '@aws-sdk/lib-dynamodb';
 import { unmarshall } from '@aws-sdk/util-dynamodb';
-import { Guards, Is, BaseError, GeneralError, Coerce, ObjectHelper, Converter } from '@twin.org/core';
+import { Guards, Is, ComponentFactory, BaseError, GeneralError, Coerce, ObjectHelper, Converter } from '@twin.org/core';
 import { EntitySchemaFactory, EntitySchemaHelper, ComparisonOperator, LogicalOperator, SortDirection } from '@twin.org/entity';
-import { LoggingConnectorFactory } from '@twin.org/logging-models';
 
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
@@ -11,11 +10,15 @@ import { LoggingConnectorFactory } from '@twin.org/logging-models';
  * Class for performing entity storage operations using Dynamo DB.
  */
 class DynamoDbEntityStorageConnector {
+    /**
+     * Runtime name for the class.
+     */
+    static CLASS_NAME = "DynamoDbEntityStorageConnector";
     /**
      * Limit the number of entities when finding.
      * @internal
      */
-    static _PAGE_SIZE = 40;
+    static _DEFAULT_LIMIT = 40;
     /**
      * Partition id field name.
      * @internal
@@ -26,10 +29,6 @@ class DynamoDbEntityStorageConnector {
      * @internal
      */
     static _PARTITION_ID_VALUE = "1";
-    /**
-     * Runtime name for the class.
-     */
-    CLASS_NAME = "DynamoDbEntityStorageConnector";
     /**
      * The schema for the entity.
      * @internal
@@ -50,13 +49,16 @@ class DynamoDbEntityStorageConnector {
      * @param options The options for the connector.
      */
     constructor(options) {
-        Guards.object(this.CLASS_NAME, "options", options);
-        Guards.stringValue(this.CLASS_NAME, "options.entitySchema", options.entitySchema);
-        Guards.object(this.CLASS_NAME, "options.config", options.config);
-        Guards.stringValue(this.CLASS_NAME, "options.config.accessKeyId", options.config.accessKeyId);
-        Guards.stringValue(this.CLASS_NAME, "options.config.secretAccessKey", options.config.secretAccessKey);
-        Guards.stringValue(this.CLASS_NAME, "options.config.region", options.config.region);
-        Guards.stringValue(this.CLASS_NAME, "options.config.tableName", options.config.tableName);
+        Guards.object(DynamoDbEntityStorageConnector.CLASS_NAME, "options", options);
+        Guards.stringValue(DynamoDbEntityStorageConnector.CLASS_NAME, "options.entitySchema", options.entitySchema);
+        Guards.object(DynamoDbEntityStorageConnector.CLASS_NAME, "options.config", options.config);
+        options.config.authMode ??= "credentials";
+        if (options.config.authMode === "credentials") {
+            Guards.stringValue(DynamoDbEntityStorageConnector.CLASS_NAME, "options.config.accessKeyId", options.config.accessKeyId);
+            Guards.stringValue(DynamoDbEntityStorageConnector.CLASS_NAME, "options.config.secretAccessKey", options.config.secretAccessKey);
+        }
+        Guards.stringValue(DynamoDbEntityStorageConnector.CLASS_NAME, "options.config.region", options.config.region);
+        Guards.stringValue(DynamoDbEntityStorageConnector.CLASS_NAME, "options.config.tableName", options.config.tableName);
         this._entitySchema = EntitySchemaFactory.get(options.entitySchema);
         this._primaryKey = EntitySchemaHelper.getPrimaryKey(this._entitySchema);
         this._config = options.config;
@@ -66,15 +68,15 @@ class DynamoDbEntityStorageConnector {
     }
     /**
      * Bootstrap the component by creating and initializing any resources it needs.
-     * @param nodeLoggingConnectorType The node logging connector type, defaults to "node-logging".
+     * @param nodeLoggingComponentType The node logging component type.
      * @returns True if the bootstrapping process was successful.
      */
-    async bootstrap(nodeLoggingConnectorType) {
-        const nodeLogging = LoggingConnectorFactory.getIfExists(nodeLoggingConnectorType ?? "node-logging");
+    async bootstrap(nodeLoggingComponentType) {
+        const nodeLogging = ComponentFactory.getIfExists(nodeLoggingComponentType);
         if (!(await this.tableExists(this._config.tableName))) {
             await nodeLogging?.log({
                 level: "info",
-                source: this.CLASS_NAME,
+                source: DynamoDbEntityStorageConnector.CLASS_NAME,
                 ts: Date.now(),
                 message: "tableCreating",
                 data: {
@@ -158,7 +160,7 @@ class DynamoDbEntityStorageConnector {
                 });
                 await nodeLogging?.log({
                     level: "info",
-                    source: this.CLASS_NAME,
+                    source: DynamoDbEntityStorageConnector.CLASS_NAME,
                     ts: Date.now(),
                     message: "tableCreated",
                     data: {
@@ -170,7 +172,7 @@ class DynamoDbEntityStorageConnector {
                 if (BaseError.isErrorCode(err, "ResourceInUseException")) {
                     await nodeLogging?.log({
                         level: "info",
-                        source: this.CLASS_NAME,
+                        source: DynamoDbEntityStorageConnector.CLASS_NAME,
                         ts: Date.now(),
                         message: "tableExists",
                         data: {
@@ -179,19 +181,16 @@ class DynamoDbEntityStorageConnector {
                     });
                 }
                 else {
-                    const errors = err instanceof AggregateError ? err.errors : [err];
-                    for (const error of errors) {
-                        await nodeLogging?.log({
-                            level: "error",
-                            source: this.CLASS_NAME,
-                            ts: Date.now(),
-                            message: "tableCreateFailed",
-                            error: BaseError.fromError(error),
-                            data: {
-                                tableName: this._config.tableName
-                            }
-                        });
-                    }
+                    await nodeLogging?.log({
+                        level: "error",
+                        source: DynamoDbEntityStorageConnector.CLASS_NAME,
+                        ts: Date.now(),
+                        message: "tableCreateFailed",
+                        error: BaseError.fromError(err),
+                        data: {
+                            tableName: this._config.tableName
+                        }
+                    });
                 }
                 return false;
             }
@@ -199,7 +198,7 @@ class DynamoDbEntityStorageConnector {
         else {
             await nodeLogging?.log({
                 level: "info",
-                source: this.CLASS_NAME,
+                source: DynamoDbEntityStorageConnector.CLASS_NAME,
                 ts: Date.now(),
                 message: "tableExists",
                 data: {
@@ -224,7 +223,7 @@ class DynamoDbEntityStorageConnector {
      * @returns The object if it can be found or undefined.
      */
     async get(id, secondaryIndex, conditions) {
-        Guards.stringValue(this.CLASS_NAME, "id", id);
+        Guards.stringValue(DynamoDbEntityStorageConnector.CLASS_NAME, "id", id);
         try {
             const docClient = this.createDocClient();
             if (Is.empty(secondaryIndex) && Is.empty(conditions)) {
@@ -263,11 +262,11 @@ class DynamoDbEntityStorageConnector {
         }
         catch (err) {
             if (BaseError.isErrorCode(err, "ResourceNotFoundException")) {
-                throw new GeneralError(this.CLASS_NAME, "tableDoesNotExist", {
-                    table: this._config.tableName
+                throw new GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "tableDoesNotExist", {
+                    tableName: this._config.tableName
                 }, err);
             }
-            throw new GeneralError(this.CLASS_NAME, "getFailed", {
+            throw new GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "getFailed", {
                 id
             }, err);
         }
@@ -279,7 +278,7 @@ class DynamoDbEntityStorageConnector {
      * @returns The id of the entity.
      */
     async set(entity, conditions) {
-        Guards.object(this.CLASS_NAME, "entity", entity);
+        Guards.object(DynamoDbEntityStorageConnector.CLASS_NAME, "entity", entity);
         EntitySchemaHelper.validateEntity(entity, this.getSchema());
         const id = entity[this._primaryKey.property];
         try {
@@ -306,11 +305,11 @@ class DynamoDbEntityStorageConnector {
                 return;
             }
             if (BaseError.isErrorCode(err, "ResourceNotFoundException")) {
-                throw new GeneralError(this.CLASS_NAME, "tableDoesNotExist", {
+                throw new GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "tableDoesNotExist", {
                     tableName: this._config.tableName
                 }, err);
             }
-            throw new GeneralError(this.CLASS_NAME, "setFailed", {
+            throw new GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "setFailed", {
                 id
             }, err);
         }
@@ -322,7 +321,7 @@ class DynamoDbEntityStorageConnector {
      * @returns Nothing.
      */
     async remove(id, conditions) {
-        Guards.stringValue(this.CLASS_NAME, "id", id);
+        Guards.stringValue(DynamoDbEntityStorageConnector.CLASS_NAME, "id", id);
         try {
             const docClient = this.createDocClient();
             const { conditionExpression, attributeNames, attributeValues } = this.buildConditionExpression(conditions);
@@ -343,11 +342,11 @@ class DynamoDbEntityStorageConnector {
                 return;
             }
             if (BaseError.isErrorCode(err, "ResourceNotFoundException")) {
-                throw new GeneralError(this.CLASS_NAME, "tableDoesNotExist", {
-                    table: this._config.tableName
+                throw new GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "tableDoesNotExist", {
+                    tableName: this._config.tableName
                 }, err);
             }
-            throw new GeneralError(this.CLASS_NAME, "removeFailed", {
+            throw new GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "removeFailed", {
                 id
             }, err);
         }
@@ -357,13 +356,13 @@ class DynamoDbEntityStorageConnector {
      * @param conditions The conditions to match for the entities.
      * @param sortProperties The optional sort order.
      * @param properties The optional properties to return, defaults to all.
-     * @param cursor The cursor to request the next page of entities.
-     * @param pageSize The suggested number of entities to return in each chunk, in some scenarios can return a different amount.
+     * @param cursor The cursor to request the next chunk of entities.
+     * @param limit The suggested number of entities to return in each chunk, in some scenarios can return a different amount.
      * @returns All the entities for the storage matching the conditions,
      * and a cursor which can be used to request more entities.
      */
-    async query(conditions, sortProperties, properties, cursor, pageSize) {
-        return this.internalQuery(conditions, sortProperties, properties, cursor, pageSize);
+    async query(conditions, sortProperties, properties, cursor, limit) {
+        return this.internalQuery(conditions, sortProperties, properties, cursor, limit);
     }
     /**
      * Delete the table.
@@ -419,7 +418,7 @@ class DynamoDbEntityStorageConnector {
         const schemaProp = this._entitySchema.properties?.find(p => p.property === condition.property);
         // It's a single value so just create the property comparison for the condition
         const comparison = this.mapComparisonOperator(objectPath, condition, schemaProp?.type, attributeNames, attributeValues);
-        const isKey = schemaProp?.isPrimary || (schemaProp?.isSecondary && schemaProp?.property === secondaryIndex);
+        const isKey = schemaProp?.isPrimary ?? (schemaProp?.isSecondary && schemaProp?.property === secondaryIndex);
         return {
             keyCondition: isKey ? comparison : "",
             filterCondition: !isKey ? comparison : ""
@@ -493,7 +492,7 @@ class DynamoDbEntityStorageConnector {
         else if (comparator.comparison === ComparisonOperator.In) {
             return `${propName} IN ${attributeName}`;
         }
-        throw new GeneralError(this.CLASS_NAME, "comparisonNotSupported", {
+        throw new GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "comparisonNotSupported", {
             comparison: comparator.comparison
         });
     }
@@ -530,7 +529,9 @@ class DynamoDbEntityStorageConnector {
         else if (operator === LogicalOperator.Or) {
             return "OR";
         }
-        throw new GeneralError(this.CLASS_NAME, "conditionalNotSupported", { operator });
+        throw new GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "conditionalNotSupported", {
+            operator
+        });
     }
     /**
      * Format a value to insert into DB.
@@ -586,11 +587,19 @@ class DynamoDbEntityStorageConnector {
      * @internal
      */
     createConnectionConfig() {
+        if (Is.stringValue(this._config.secretAccessKey) &&
+            Is.stringValue(this._config.accessKeyId) &&
+            this._config.authMode === "credentials") {
+            return {
+                credentials: {
+                    accessKeyId: this._config.accessKeyId,
+                    secretAccessKey: this._config.secretAccessKey
+                },
+                endpoint: this._config.endpoint,
+                region: this._config.region
+            };
+        }
         return {
-            credentials: {
-                accessKeyId: this._config.accessKeyId,
-                secretAccessKey: this._config.secretAccessKey
-            },
             endpoint: this._config.endpoint,
             region: this._config.region
         };
@@ -616,16 +625,16 @@ class DynamoDbEntityStorageConnector {
      * @param conditions The conditions to match for the entities.
      * @param sortProperties The optional sort order.
      * @param properties The optional properties to return, defaults to all.
-     * @param cursor The cursor to request the next page of entities.
-     * @param pageSize The suggested number of entities to return in each chunk, in some scenarios can return a different amount.
+     * @param cursor The cursor to request the next chunk of entities.
+     * @param limit The suggested number of entities to return in each chunk, in some scenarios can return a different amount.
      * @param secondaryIndex The secondary index to use for the query.
      * @returns All the entities for the storage matching the conditions,
      * and a cursor which can be used to request more entities.
      * @internal
      */
-    async internalQuery(conditions, sortProperties, properties, cursor, pageSize, secondaryIndex) {
+    async internalQuery(conditions, sortProperties, properties, cursor, limit, secondaryIndex) {
         try {
-            const returnSize = pageSize ?? DynamoDbEntityStorageConnector._PAGE_SIZE;
+            const returnSize = limit ?? DynamoDbEntityStorageConnector._DEFAULT_LIMIT;
             let indexName = Is.stringValue(secondaryIndex)
                 ? `${secondaryIndex}Index`
                 : undefined;
@@ -634,7 +643,7 @@ class DynamoDbEntityStorageConnector {
             let scanAscending = true;
             if (Is.arrayValue(sortProperties)) {
                 if (sortProperties.length > 1) {
-                    throw new GeneralError(this.CLASS_NAME, "sortSingle");
+                    throw new GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "sortSingle");
                 }
                 for (const sortProperty of sortProperties) {
                     const propertySchema = this._entitySchema.properties?.find(e => e.property === sortProperty.property);
@@ -642,7 +651,7 @@ class DynamoDbEntityStorageConnector {
                         (!propertySchema.isPrimary &&
                             !propertySchema.isSecondary &&
                             Is.empty(propertySchema.sortDirection))) {
-                        throw new GeneralError(this.CLASS_NAME, "sortNotIndexed", {
+                        throw new GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "sortNotIndexed", {
                             property: sortProperty.property
                         });
                     }
@@ -698,11 +707,11 @@ class DynamoDbEntityStorageConnector {
         }
         catch (err) {
             if (BaseError.isErrorCode(err, "ResourceNotFoundException")) {
-                throw new GeneralError(this.CLASS_NAME, "tableDoesNotExist", {
-                    table: this._config.tableName
+                throw new GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "tableDoesNotExist", {
+                    tableName: this._config.tableName
                 }, err);
             }
-            throw new GeneralError(this.CLASS_NAME, "queryFailed", undefined, err);
+            throw new GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "queryFailed", undefined, err);
         }
     }
     /**
@@ -721,7 +730,7 @@ class DynamoDbEntityStorageConnector {
             for (const c of conditions) {
                 const schemaProp = this._entitySchema.properties?.find(p => p.property === c.property);
                 if (Is.undefined(schemaProp)) {
-                    throw new GeneralError(this.CLASS_NAME, "propertyNotFound", {
+                    throw new GeneralError(DynamoDbEntityStorageConnector.CLASS_NAME, "propertyNotFound", {
                         property: c.property
                     });
                 }

package/dist/types/dynamoDbEntityStorageConnector.d.ts

@@ -8,7 +8,7 @@ export declare class DynamoDbEntityStorageConnector<T = unknown> implements IEnt
     /**
      * Runtime name for the class.
      */
-    readonly CLASS_NAME: string;
+    static readonly CLASS_NAME: string;
     /**
      * Create a new instance of DynamoDbEntityStorageConnector.
      * @param options The options for the connector.
@@ -16,10 +16,10 @@ export declare class DynamoDbEntityStorageConnector<T = unknown> implements IEnt
     constructor(options: IDynamoDbEntityStorageConnectorConstructorOptions);
     /**
      * Bootstrap the component by creating and initializing any resources it needs.
-     * @param nodeLoggingConnectorType The node logging connector type, defaults to "node-logging".
+     * @param nodeLoggingComponentType The node logging component type.
      * @returns True if the bootstrapping process was successful.
      */
-    bootstrap(nodeLoggingConnectorType?: string): Promise<boolean>;
+    bootstrap(nodeLoggingComponentType?: string): Promise<boolean>;
     /**
      * Get the schema for the entities.
      * @returns The schema for the entities.
@@ -61,15 +61,15 @@ export declare class DynamoDbEntityStorageConnector<T = unknown> implements IEnt
      * @param conditions The conditions to match for the entities.
      * @param sortProperties The optional sort order.
      * @param properties The optional properties to return, defaults to all.
-     * @param cursor The cursor to request the next page of entities.
-     * @param pageSize The suggested number of entities to return in each chunk, in some scenarios can return a different amount.
+     * @param cursor The cursor to request the next chunk of entities.
+     * @param limit The suggested number of entities to return in each chunk, in some scenarios can return a different amount.
      * @returns All the entities for the storage matching the conditions,
      * and a cursor which can be used to request more entities.
      */
     query(conditions?: EntityCondition<T>, sortProperties?: {
         property: keyof T;
         sortDirection: SortDirection;
-    }[], properties?: (keyof T)[], cursor?: string, pageSize?: number): Promise<{
+    }[], properties?: (keyof T)[], cursor?: string, limit?: number): Promise<{
         /**
          * The entities, which can be partial if a limited keys list was provided.
          */

package/dist/types/models/IDynamoDbEntityStorageConnectorConfig.d.ts

@@ -7,19 +7,26 @@ export interface IDynamoDbEntityStorageConnectorConfig {
      */
     region: string;
     /**
-     * The AWS access key.
+     * The authentication mode.
+     * - "credentials": Use access key ID and secret access key.
+     * - "pod": Use IAM role attached to the pod (e.g., in EKS).
+     * @default credentials
      */
-    accessKeyId: string;
+    authMode?: "credentials" | "pod";
+    /**
+     * The AWS access key ID.
+     */
+    accessKeyId?: string;
     /**
      * The AWS secret access key.
      */
-    secretAccessKey: string;
+    secretAccessKey?: string;
     /**
      * The name of the table for the storage.
      */
     tableName: string;
     /**
-     * AWS endpoint, not usually required but could be used for local DynamoDB instance e.g. http://localhost:8000.
+     * AWS endpoint, not usually required but could be used for local DynamoDB instance e.g. http://localhost:8500.
      */
     endpoint?: string;
 }

package/dist/types/models/IDynamoDbEntityStorageConnectorConstructorOptions.d.ts

@@ -8,9 +8,9 @@ export interface IDynamoDbEntityStorageConnectorConstructorOptions {
      */
     entitySchema: string;
     /**
-     * The type of logging connector to use, defaults to no logging.
+     * The type of logging component to use, defaults to no logging.
      */
-    loggingConnectorType?: string;
+    loggingComponentType?: string;
     /**
      * The configuration for the connector.
      */

package/docs/changelog.md

@@ -1,5 +1,149 @@
 # @twin.org/entity-storage-connector-dynamodb - Changelog
 
+## [0.0.2-next.10](https://github.com/twinfoundation/entity-storage/compare/entity-storage-connector-dynamodb-v0.0.2-next.9...entity-storage-connector-dynamodb-v0.0.2-next.10) (2025-10-09)
+
+
+### Features
+
+* add validate-locales ([e66ef0d](https://github.com/twinfoundation/entity-storage/commit/e66ef0de26ca2f82b3fe89bb5c7a15a0978a9644))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.0.2-next.9 to 0.0.2-next.10
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.0.2-next.9 to 0.0.2-next.10
+
+## [0.0.2-next.9](https://github.com/twinfoundation/entity-storage/compare/entity-storage-connector-dynamodb-v0.0.2-next.8...entity-storage-connector-dynamodb-v0.0.2-next.9) (2025-10-02)
+
+
+### Features
+
+* add AWS pod authentication mode ([caaae36](https://github.com/twinfoundation/entity-storage/commit/caaae368ca104cd9994e1af7b6c4c20e603c2021))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.0.2-next.8 to 0.0.2-next.9
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.0.2-next.8 to 0.0.2-next.9
+
+## [0.0.2-next.8](https://github.com/twinfoundation/entity-storage/compare/entity-storage-connector-dynamodb-v0.0.2-next.7...entity-storage-connector-dynamodb-v0.0.2-next.8) (2025-08-29)
+
+
+### Features
+
+* eslint migration to flat config ([f033b64](https://github.com/twinfoundation/entity-storage/commit/f033b64984c0e6a8129d929c9dd816dcc1b8dab0))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.0.2-next.7 to 0.0.2-next.8
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.0.2-next.7 to 0.0.2-next.8
+
+## [0.0.2-next.7](https://github.com/twinfoundation/entity-storage/compare/entity-storage-connector-dynamodb-v0.0.2-next.6...entity-storage-connector-dynamodb-v0.0.2-next.7) (2025-08-20)
+
+
+### Features
+
+* logging naming consistency ([f99d12d](https://github.com/twinfoundation/entity-storage/commit/f99d12dea04b6d4f2b5632ff5473e9ec7d5f9055))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.0.2-next.6 to 0.0.2-next.7
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.0.2-next.6 to 0.0.2-next.7
+
+## [0.0.2-next.6](https://github.com/twinfoundation/entity-storage/compare/entity-storage-connector-dynamodb-v0.0.2-next.5...entity-storage-connector-dynamodb-v0.0.2-next.6) (2025-08-19)
+
+
+### Features
+
+* update framework core ([b59a380](https://github.com/twinfoundation/entity-storage/commit/b59a380bb7fba2b43610f69074dcdee24a4737da))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.0.2-next.5 to 0.0.2-next.6
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.0.2-next.5 to 0.0.2-next.6
+
+## [0.0.2-next.5](https://github.com/twinfoundation/entity-storage/compare/entity-storage-connector-dynamodb-v0.0.2-next.4...entity-storage-connector-dynamodb-v0.0.2-next.5) (2025-08-11)
+
+
+### Miscellaneous Chores
+
+* **entity-storage-connector-dynamodb:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.0.2-next.4 to 0.0.2-next.5
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.0.2-next.4 to 0.0.2-next.5
+
+## [0.0.2-next.4](https://github.com/twinfoundation/entity-storage/compare/entity-storage-connector-dynamodb-v0.0.2-next.3...entity-storage-connector-dynamodb-v0.0.2-next.4) (2025-08-08)
+
+
+### Miscellaneous Chores
+
+* **entity-storage-connector-dynamodb:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.0.2-next.3 to 0.0.2-next.4
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.0.2-next.3 to 0.0.2-next.4
+
+## [0.0.2-next.3](https://github.com/twinfoundation/entity-storage/compare/entity-storage-connector-dynamodb-v0.0.2-next.2...entity-storage-connector-dynamodb-v0.0.2-next.3) (2025-07-25)
+
+
+### Features
+
+* add synchronised to release configs ([e1e749c](https://github.com/twinfoundation/entity-storage/commit/e1e749cf261b58c8c36729686861e29c7d5e068e))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.0.2-next.2 to 0.0.2-next.3
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.0.2-next.2 to 0.0.2-next.3
+
+## [0.0.2-next.2](https://github.com/twinfoundation/entity-storage/compare/entity-storage-connector-dynamodb-v0.0.2-next.1...entity-storage-connector-dynamodb-v0.0.2-next.2) (2025-07-24)
+
+
+### Features
+
+* synchronised storage ([#44](https://github.com/twinfoundation/entity-storage/issues/44)) ([94e10e2](https://github.com/twinfoundation/entity-storage/commit/94e10e26d1feec801449dc04af7a9757ac7495ff))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.0.2-next.1 to 0.0.2-next.2
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.0.2-next.1 to 0.0.2-next.2
+
 ## [0.0.2-next.1](https://github.com/twinfoundation/entity-storage/compare/entity-storage-connector-dynamodb-v0.0.2-next.0...entity-storage-connector-dynamodb-v0.0.2-next.1) (2025-07-17)
 
 

package/docs/reference/classes/DynamoDbEntityStorageConnector.md

@@ -36,29 +36,25 @@ The options for the connector.
 
 ### CLASS\_NAME
 
-> `readonly` **CLASS\_NAME**: `string`
+> `readonly` `static` **CLASS\_NAME**: `string`
 
 Runtime name for the class.
 
-#### Implementation of
-
-`IEntityStorageConnector.CLASS_NAME`
-
 ## Methods
 
 ### bootstrap()
 
-> **bootstrap**(`nodeLoggingConnectorType?`): `Promise`\<`boolean`\>
+> **bootstrap**(`nodeLoggingComponentType?`): `Promise`\<`boolean`\>
 
 Bootstrap the component by creating and initializing any resources it needs.
 
 #### Parameters
 
-##### nodeLoggingConnectorType?
+##### nodeLoggingComponentType?
 
 `string`
 
-The node logging connector type, defaults to "node-logging".
+The node logging component type.
 
 #### Returns
 
@@ -194,7 +190,7 @@ Nothing.
 
 ### query()
 
-> **query**(`conditions?`, `sortProperties?`, `properties?`, `cursor?`, `pageSize?`): `Promise`\<\{ `entities`: `Partial`\<`T`\>[]; `cursor?`: `string`; \}\>
+> **query**(`conditions?`, `sortProperties?`, `properties?`, `cursor?`, `limit?`): `Promise`\<\{ `entities`: `Partial`\<`T`\>[]; `cursor?`: `string`; \}\>
 
 Find all the entities which match the conditions.
 
@@ -222,9 +218,9 @@ The optional properties to return, defaults to all.
 
 `string`
 
-The cursor to request the next page of entities.
+The cursor to request the next chunk of entities.
 
-##### pageSize?
+##### limit?
 
 `number`
 

package/docs/reference/interfaces/IDynamoDbEntityStorageConnectorConfig.md

@@ -12,17 +12,33 @@ The region for the AWS connection.
 
 ***
 
-### accessKeyId
+### authMode?
 
-> **accessKeyId**: `string`
+> `optional` **authMode**: `"credentials"` \| `"pod"`
 
-The AWS access key.
+The authentication mode.
+- "credentials": Use access key ID and secret access key.
+- "pod": Use IAM role attached to the pod (e.g., in EKS).
+
+#### Default
+
+```ts
+credentials
+```
+
+***
+
+### accessKeyId?
+
+> `optional` **accessKeyId**: `string`
+
+The AWS access key ID.
 
 ***
 
-### secretAccessKey
+### secretAccessKey?
 
-> **secretAccessKey**: `string`
+> `optional` **secretAccessKey**: `string`
 
 The AWS secret access key.
 
@@ -40,4 +56,4 @@ The name of the table for the storage.
 
 > `optional` **endpoint**: `string`
 
-AWS endpoint, not usually required but could be used for local DynamoDB instance e.g. http://localhost:8000.
+AWS endpoint, not usually required but could be used for local DynamoDB instance e.g. http://localhost:8500.

package/docs/reference/interfaces/IDynamoDbEntityStorageConnectorConstructorOptions.md

@@ -12,11 +12,11 @@ The schema for the entity
 
 ***
 
-### loggingConnectorType?
+### loggingComponentType?
 
-> `optional` **loggingConnectorType**: `string`
+> `optional` **loggingComponentType**: `string`
 
-The type of logging connector to use, defaults to no logging.
+The type of logging component to use, defaults to no logging.
 
 ***
 

package/locales/en.json

@@ -17,7 +17,8 @@
 			"comparisonNotSupported": "Comparison operator \"{comparison}\" is not supported",
 			"conditionalNotSupported": "Conditional operator \"{operator}\" is not supported",
 			"sortSingle": "You can only sort by a single property",
-			"sortNotIndexed": "The property \"{property}\" is not indexed and cannot be used for sorting"
+			"sortNotIndexed": "The property \"{property}\" is not indexed and cannot be used for sorting",
+			"propertyNotFound": "The property \"{property}\" was not found on the entity schema"
 		}
 	}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/entity-storage-connector-dynamodb",
-	"version": "0.0.2-next.1",
+	"version": "0.0.2-next.10",
 	"description": "Entity Storage connector implementation using DynamoDb storage",
 	"repository": {
 		"type": "git",
@@ -14,12 +14,12 @@
 		"node": ">=20.0.0"
 	},
 	"dependencies": {
-		"@aws-sdk/client-dynamodb": "3.844",
-		"@aws-sdk/lib-dynamodb": "3.844",
-		"@aws-sdk/util-dynamodb": "3.844",
+		"@aws-sdk/client-dynamodb": "3.906",
+		"@aws-sdk/lib-dynamodb": "3.906",
+		"@aws-sdk/util-dynamodb": "3.906",
 		"@twin.org/core": "next",
 		"@twin.org/entity": "next",
-		"@twin.org/entity-storage-models": "0.0.2-next.1",
+		"@twin.org/entity-storage-models": "0.0.2-next.10",
 		"@twin.org/logging-models": "next",
 		"@twin.org/nameof": "next"
 	},
@@ -40,5 +40,24 @@
 		"dist/types",
 		"locales",
 		"docs"
-	]
+	],
+	"keywords": [
+		"twin",
+		"trade",
+		"iota",
+		"framework",
+		"blockchain",
+		"entity-storage",
+		"entity",
+		"storage",
+		"persistence",
+		"database",
+		"connector",
+		"adapter",
+		"integration"
+	],
+	"bugs": {
+		"url": "git+https://github.com/twinfoundation/entity-storage/issues"
+	},
+	"homepage": "https://twindev.org"
 }