@twin.org/entity-storage-connector-postgresql 0.9.2-next.1 → 0.9.2-next.11

package/docs/changelog.md

@@ -1,5 +1,166 @@
 # Changelog
 
+## [0.9.2-next.11](https://github.com/iotaledger/twin-entity-storage/compare/entity-storage-connector-postgresql-v0.9.2-next.10...entity-storage-connector-postgresql-v0.9.2-next.11) (2026-08-16)
+
+
+### Bug Fixes
+
+* skip partition ids with mismatched depth during partition enumeration ([#218](https://github.com/iotaledger/twin-entity-storage/issues/218)) ([8fc2386](https://github.com/iotaledger/twin-entity-storage/commit/8fc238699e2891f0c982530c011fe4438004b0ae))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.9.2-next.10 to 0.9.2-next.11
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.9.2-next.10 to 0.9.2-next.11
+
+## [0.9.2-next.10](https://github.com/iotaledger/twin-entity-storage/compare/entity-storage-connector-postgresql-v0.9.2-next.9...entity-storage-connector-postgresql-v0.9.2-next.10) (2026-08-14)
+
+
+### Miscellaneous Chores
+
+* **entity-storage-connector-postgresql:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.9.2-next.9 to 0.9.2-next.10
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.9.2-next.9 to 0.9.2-next.10
+
+## [0.9.2-next.9](https://github.com/iotaledger/twin-entity-storage/compare/entity-storage-connector-postgresql-v0.9.2-next.8...entity-storage-connector-postgresql-v0.9.2-next.9) (2026-08-12)
+
+
+### Bug Fixes
+
+* use hashing to restrict index name length ([757d572](https://github.com/iotaledger/twin-entity-storage/commit/757d5728161a00c1d1865ad6df3231eecfad16f2))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.9.2-next.8 to 0.9.2-next.9
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.9.2-next.8 to 0.9.2-next.9
+
+## [0.9.2-next.8](https://github.com/iotaledger/twin-entity-storage/compare/entity-storage-connector-postgresql-v0.9.2-next.7...entity-storage-connector-postgresql-v0.9.2-next.8) (2026-08-12)
+
+
+### Features
+
+* indexing ([#207](https://github.com/iotaledger/twin-entity-storage/issues/207)) ([2fd1f0d](https://github.com/iotaledger/twin-entity-storage/commit/2fd1f0d992344905c9dd1a44addfc4f9d5b5c168))
+* pooled connections ([#208](https://github.com/iotaledger/twin-entity-storage/issues/208)) ([5d832d1](https://github.com/iotaledger/twin-entity-storage/commit/5d832d15b0639f13ad3f5d2c68c946a72264310a))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.9.2-next.7 to 0.9.2-next.8
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.9.2-next.7 to 0.9.2-next.8
+
+## [0.9.2-next.7](https://github.com/iotaledger/twin-entity-storage/compare/entity-storage-connector-postgresql-v0.9.2-next.6...entity-storage-connector-postgresql-v0.9.2-next.7) (2026-08-11)
+
+
+### Features
+
+* optimistic locking ([#201](https://github.com/iotaledger/twin-entity-storage/issues/201)) ([80cbe3b](https://github.com/iotaledger/twin-entity-storage/commit/80cbe3b611c47b16328bceab02cfb8423fe1bbcd))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.9.2-next.6 to 0.9.2-next.7
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.9.2-next.6 to 0.9.2-next.7
+
+## [0.9.2-next.6](https://github.com/iotaledger/twin-entity-storage/compare/entity-storage-connector-postgresql-v0.9.2-next.5...entity-storage-connector-postgresql-v0.9.2-next.6) (2026-08-07)
+
+
+### Bug Fixes
+
+* allow multi-property sort on DynamoDB and CosmosDB connectors ([#196](https://github.com/iotaledger/twin-entity-storage/issues/196)) ([f1bb582](https://github.com/iotaledger/twin-entity-storage/commit/f1bb5826d75dae331ad6b42df5de330a308c5405))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.9.2-next.5 to 0.9.2-next.6
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.9.2-next.5 to 0.9.2-next.6
+
+## [0.9.2-next.5](https://github.com/iotaledger/twin-entity-storage/compare/entity-storage-connector-postgresql-v0.9.2-next.4...entity-storage-connector-postgresql-v0.9.2-next.5) (2026-08-07)
+
+
+### Features
+
+* linting and dependency update ([c307b60](https://github.com/iotaledger/twin-entity-storage/commit/c307b606d03ea436b7c43d4e1764b5c08f415555))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.9.2-next.4 to 0.9.2-next.5
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.9.2-next.4 to 0.9.2-next.5
+
+## [0.9.2-next.4](https://github.com/iotaledger/twin-entity-storage/compare/entity-storage-connector-postgresql-v0.9.2-next.3...entity-storage-connector-postgresql-v0.9.2-next.4) (2026-08-04)
+
+
+### Bug Fixes
+
+* schema version check crashes in multi-tenant mode ([#192](https://github.com/iotaledger/twin-entity-storage/issues/192)) ([a816341](https://github.com/iotaledger/twin-entity-storage/commit/a8163415ce116582f3c3c23294f7f4062099d8f3))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.9.2-next.3 to 0.9.2-next.4
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.9.2-next.3 to 0.9.2-next.4
+
+## [0.9.2-next.3](https://github.com/iotaledger/twin-entity-storage/compare/entity-storage-connector-postgresql-v0.9.2-next.2...entity-storage-connector-postgresql-v0.9.2-next.3) (2026-08-03)
+
+
+### Features
+
+* update health signatures ([#188](https://github.com/iotaledger/twin-entity-storage/issues/188)) ([0159094](https://github.com/iotaledger/twin-entity-storage/commit/015909423958a7a20505a92b23793a044d26f6a4))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.9.2-next.2 to 0.9.2-next.3
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.9.2-next.2 to 0.9.2-next.3
+
+## [0.9.2-next.2](https://github.com/iotaledger/twin-entity-storage/compare/entity-storage-connector-postgresql-v0.9.2-next.1...entity-storage-connector-postgresql-v0.9.2-next.2) (2026-07-29)
+
+
+### Miscellaneous Chores
+
+* **entity-storage-connector-postgresql:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.9.2-next.1 to 0.9.2-next.2
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.9.2-next.1 to 0.9.2-next.2
+
 ## [0.9.2-next.1](https://github.com/iotaledger/twin-entity-storage/compare/entity-storage-connector-postgresql-v0.9.2-next.0...entity-storage-connector-postgresql-v0.9.2-next.1) (2026-07-29)
 
 

package/docs/reference/classes/PostgreSqlEntityStorageConnector.md

@@ -11,6 +11,7 @@ Class for performing entity storage operations using ql.
 ## Implements
 
 - `IEntityStorageMigrationConnector`\<`T`\>
+- `IHealthProviderComponent`
 
 ## Constructors
 
@@ -90,17 +91,17 @@ The class name of the component.
 
 > **health**(): `Promise`\<`IHealth`[]\>
 
-Get the health of the component.
+Returns the health status of the component.
 
 #### Returns
 
 `Promise`\<`IHealth`[]\>
 
-The health of the component.
+The health status of the component.
 
 #### Implementation of
 
-`IEntityStorageMigrationConnector.health`
+`IHealthProviderComponent.health`
 
 ***
 
@@ -204,6 +205,10 @@ The optional conditions to match for the entities.
 
 The id of the entity.
 
+#### Throws
+
+ConflictError when the entity exists but the supplied conditions or version do not match the stored state.
+
 #### Implementation of
 
 `IEntityStorageMigrationConnector.set`
@@ -338,12 +343,38 @@ True if the teardown process was successful.
 
 ***
 
+### connectorVersion() {#connectorversion}
+
+> **connectorVersion**(): `number`
+
+Get the connector implementation version.
+
+#### Returns
+
+`number`
+
+The connector implementation version.
+
+#### Implementation of
+
+`IEntityStorageMigrationConnector.connectorVersion`
+
+***
+
 ### getPartitionContextIds() {#getpartitioncontextids}
 
-> **getPartitionContextIds**(): `Promise`\<`IContextIds`[] \| `undefined`\>
+> **getPartitionContextIds**(`loggingComponentType?`): `Promise`\<`IContextIds`[] \| `undefined`\>
 
 Get all the distinct partition context ids from the storage.
 
+#### Parameters
+
+##### loggingComponentType?
+
+`string`
+
+The optional component type to use for logging skipped partition ids.
+
 #### Returns
 
 `Promise`\<`IContextIds`[] \| `undefined`\>

package/docs/reference/interfaces/IPostgreSqlEntityStorageConnectorConfig.md

@@ -49,3 +49,55 @@ The name of the database to be used.
 > **tableName**: `string`
 
 The name of the table to be used.
+
+***
+
+### pool? {#pool}
+
+> `optional` **pool?**: `object`
+
+Optional connection pool configuration.
+
+#### max?
+
+> `optional` **max?**: `number`
+
+Maximum number of connections in the pool.
+
+##### Default
+
+```ts
+10
+```
+
+#### idleTimeout?
+
+> `optional` **idleTimeout?**: `number`
+
+Seconds a connection can remain idle before being closed.
+
+#### connectTimeout?
+
+> `optional` **connectTimeout?**: `number`
+
+Seconds to wait when establishing a connection.
+
+##### Default
+
+```ts
+30
+```
+
+#### maxLifetime?
+
+> `optional` **maxLifetime?**: `number`
+
+Maximum seconds a connection can remain open.
+
+***
+
+### mutexTimeoutMs? {#mutextimeoutms}
+
+> `optional` **mutexTimeoutMs?**: `number`
+
+Milliseconds to wait for connector mutex locks before throwing.

package/locales/en.json

@@ -9,8 +9,15 @@
 			"tableDropped": "Table \"{tableName}\" dropped"
 		}
 	},
+	"warn": {
+		"postgreSqlEntityStorageConnector": {
+			"partitionIdsSkipped": "Skipping partition ids whose depth does not match the {expected} configured partition keys: {partitionIds}. Entities in these partitions are ignored by migration."
+		}
+	},
 	"error": {
 		"postgreSqlEntityStorageConnector": {
+			"optimisticLockFailed": "The entity \"{conflictId}\" could not be written because the optimistic lock check failed",
+			"conditionFailed": "The entity \"{conflictId}\" could not be updated because the supplied conditions did not match the stored state",
 			"databaseCreateFailed": "Unable to create database \"{databaseName}\"",
 			"setFailed": "Unable to set entity \"{id}\"",
 			"getFailed": "Unable to get entity \"{id}\"",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/entity-storage-connector-postgresql",
-	"version": "0.9.2-next.1",
+	"version": "0.9.2-next.11",
 	"description": "PostgreSQL connector for relational persistence and advanced SQL features.",
 	"repository": {
 		"type": "git",
@@ -14,10 +14,11 @@
 		"node": ">=24.0.0"
 	},
 	"dependencies": {
+		"@twin.org/api-models": "next",
 		"@twin.org/context": "next",
 		"@twin.org/core": "next",
 		"@twin.org/entity": "next",
-		"@twin.org/entity-storage-models": "0.9.2-next.1",
+		"@twin.org/entity-storage-models": "0.9.2-next.11",
 		"@twin.org/logging-models": "next",
 		"@twin.org/nameof": "next",
 		"postgres": "3.4.9"