@twin.org/entity-storage-connector-cosmosdb 0.0.1-next.13 → 0.0.1-next.15

package/dist/cjs/index.cjs

@@ -63,9 +63,6 @@ class CosmosDbEntityStorageConnector {
     /**
      * Create a new instance of CosmosDbEntityStorageConnector.
      * @param options The options for the connector.
-     * @param options.entitySchema The schema for the entity.
-     * @param options.loggingConnectorType The type of logging connector to use, defaults to no logging.
-     * @param options.config The configuration for the connector.
      */
     constructor(options) {
         core.Guards.object(this.CLASS_NAME, "options", options);

package/dist/esm/index.mjs

@@ -61,9 +61,6 @@ class CosmosDbEntityStorageConnector {
     /**
      * Create a new instance of CosmosDbEntityStorageConnector.
      * @param options The options for the connector.
-     * @param options.entitySchema The schema for the entity.
-     * @param options.loggingConnectorType The type of logging connector to use, defaults to no logging.
-     * @param options.config The configuration for the connector.
      */
     constructor(options) {
         Guards.object(this.CLASS_NAME, "options", options);

package/dist/types/cosmosDbEntityStorageConnector.d.ts

@@ -1,6 +1,6 @@
 import { type EntityCondition, type IEntitySchema, SortDirection } from "@twin.org/entity";
 import type { IEntityStorageConnector } from "@twin.org/entity-storage-models";
-import type { ICosmosDbEntityStorageConnectorConfig } from "./models/ICosmosDbEntityStorageConnectorConfig";
+import type { ICosmosDbEntityStorageConnectorConstructorOptions } from "./models/ICosmosDbEntityStorageConnectorConstructorOptions";
 /**
  * Class for performing entity storage operations using Cosmos DB.
  */
@@ -12,15 +12,8 @@ export declare class CosmosDbEntityStorageConnector<T = unknown> implements IEnt
     /**
      * Create a new instance of CosmosDbEntityStorageConnector.
      * @param options The options for the connector.
-     * @param options.entitySchema The schema for the entity.
-     * @param options.loggingConnectorType The type of logging connector to use, defaults to no logging.
-     * @param options.config The configuration for the connector.
      */
-    constructor(options: {
-        entitySchema: string;
-        loggingConnectorType?: string;
-        config: ICosmosDbEntityStorageConnectorConfig;
-    });
+    constructor(options: ICosmosDbEntityStorageConnectorConstructorOptions);
     /**
      * Initialize the Cosmos DB environment.
      * @param nodeLoggingConnectorType Optional type of the logging connector.

package/dist/types/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./cosmosDbEntityStorageConnector";
 export * from "./models/ICosmosDbEntityStorageConnectorConfig";
+export * from "./models/ICosmosDbEntityStorageConnectorConstructorOptions";

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

@@ -0,0 +1,19 @@
+import type { ICosmosDbEntityStorageConnectorConfig } from "./ICosmosDbEntityStorageConnectorConfig";
+/**
+ * The options for the cosmos db entity storage connector constructor.
+ */
+export interface ICosmosDbEntityStorageConnectorConstructorOptions {
+    /**
+     * The schema for the entity.
+     */
+    entitySchema: string;
+    /**
+     * The type of logging connector to use.
+     * @default logging
+     */
+    loggingConnectorType?: string;
+    /**
+     * The configuration for the connector.
+     */
+    config: ICosmosDbEntityStorageConnectorConfig;
+}

package/docs/changelog.md

@@ -1,5 +1,5 @@
 # @twin.org/entity-storage-connector-cosmosdb - Changelog
 
-## v0.0.1-next.13
+## v0.0.1-next.15
 
 - Initial Release

package/docs/reference/classes/CosmosDbEntityStorageConnector.md

@@ -20,21 +20,11 @@ Create a new instance of CosmosDbEntityStorageConnector.
 
 #### Parameters
 
-• **options**
+##### options
 
-The options for the connector.
-
-• **options.entitySchema**: `string`
-
-The schema for the entity.
-
-• **options.loggingConnectorType?**: `string`
+[`ICosmosDbEntityStorageConnectorConstructorOptions`](../interfaces/ICosmosDbEntityStorageConnectorConstructorOptions.md)
 
-The type of logging connector to use, defaults to no logging.
-
-• **options.config**: [`ICosmosDbEntityStorageConnectorConfig`](../interfaces/ICosmosDbEntityStorageConnectorConfig.md)
-
-The configuration for the connector.
+The options for the connector.
 
 #### Returns
 
@@ -62,7 +52,9 @@ Initialize the Cosmos DB environment.
 
 #### Parameters
 
-• **nodeLoggingConnectorType?**: `string`
+##### nodeLoggingConnectorType?
+
+`string`
 
 Optional type of the logging connector.
 
@@ -80,13 +72,13 @@ A promise that resolves to a boolean indicating success.
 
 ### getSchema()
 
-> **getSchema**(): `IEntitySchema`\<`unknown`\>
+> **getSchema**(): `IEntitySchema`
 
 Get the schema for the entities.
 
 #### Returns
 
-`IEntitySchema`\<`unknown`\>
+`IEntitySchema`
 
 The schema for the entities.
 
@@ -104,15 +96,21 @@ Get an entity from Cosmos DB.
 
 #### Parameters
 
-• **id**: `string`
+##### id
+
+`string`
 
 The id of the entity to get, or the index value if secondaryIndex is set.
 
-• **secondaryIndex?**: keyof `T`
+##### secondaryIndex?
+
+keyof `T`
 
 Get the item using a secondary index.
 
-• **conditions?**: `object`[]
+##### conditions?
+
+`object`[]
 
 The optional conditions to match for the entities.
 
@@ -136,11 +134,15 @@ Set an entity.
 
 #### Parameters
 
-• **entity**: `T`
+##### entity
+
+`T`
 
 The entity to set.
 
-• **conditions?**: `object`[]
+##### conditions?
+
+`object`[]
 
 The optional conditions to match for the entities.
 
@@ -164,11 +166,15 @@ Remove the entity.
 
 #### Parameters
 
-• **id**: `string`
+##### id
+
+`string`
 
 The id of the entity to remove.
 
-• **conditions?**: `object`[]
+##### conditions?
+
+`object`[]
 
 The optional conditions to match for the entities.
 
@@ -186,47 +192,49 @@ Nothing.
 
 ### query()
 
-> **query**(`conditions`?, `sortProperties`?, `properties`?, `cursor`?, `pageSize`?): `Promise`\<`object`\>
+> **query**(`conditions`?, `sortProperties`?, `properties`?, `cursor`?, `pageSize`?): `Promise`\<\{ `entities`: `Partial`\<`T`\>[]; `cursor`: `string`; \}\>
 
 Find all the entities which match the conditions.
 
 #### Parameters
 
-• **conditions?**: `EntityCondition`\<`T`\>
+##### conditions?
+
+`EntityCondition`\<`T`\>
 
 The conditions to match for the entities.
 
-• **sortProperties?**: `object`[]
+##### sortProperties?
+
+`object`[]
 
 The optional sort order.
 
-• **properties?**: keyof `T`[]
+##### properties?
+
+keyof `T`[]
 
 The optional properties to return, defaults to all.
 
-• **cursor?**: `string`
+##### cursor?
+
+`string`
 
 The cursor to request the next page of entities.
 
-• **pageSize?**: `number`
+##### pageSize?
+
+`number`
 
 The suggested number of entities to return in each chunk, in some scenarios can return a different amount.
 
 #### Returns
 
-`Promise`\<`object`\>
+`Promise`\<\{ `entities`: `Partial`\<`T`\>[]; `cursor`: `string`; \}\>
 
 All the entities for the storage matching the conditions,
 and a cursor which can be used to request more entities.
 
-##### entities
-
-> **entities**: `Partial`\<`T`\>[]
-
-##### cursor?
-
-> `optional` **cursor**: `string`
-
 #### Implementation of
 
 `IEntityStorageConnector.query`

package/docs/reference/index.md

@@ -7,3 +7,4 @@
 ## Interfaces
 
 - [ICosmosDbEntityStorageConnectorConfig](interfaces/ICosmosDbEntityStorageConnectorConfig.md)
+- [ICosmosDbEntityStorageConnectorConstructorOptions](interfaces/ICosmosDbEntityStorageConnectorConstructorOptions.md)

package/docs/reference/interfaces/ICosmosDbEntityStorageConnectorConstructorOptions.md

@@ -0,0 +1,33 @@
+# Interface: ICosmosDbEntityStorageConnectorConstructorOptions
+
+The options for the cosmos db entity storage connector constructor.
+
+## Properties
+
+### entitySchema
+
+> **entitySchema**: `string`
+
+The schema for the entity.
+
+***
+
+### loggingConnectorType?
+
+> `optional` **loggingConnectorType**: `string`
+
+The type of logging connector to use.
+
+#### Default
+
+```ts
+logging
+```
+
+***
+
+### config
+
+> **config**: [`ICosmosDbEntityStorageConnectorConfig`](ICosmosDbEntityStorageConnectorConfig.md)
+
+The configuration for the connector.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/entity-storage-connector-cosmosdb",
-	"version": "0.0.1-next.13",
+	"version": "0.0.1-next.15",
 	"description": "Entity Storage connector implementation using CosmosDB storage",
 	"repository": {
 		"type": "git",
@@ -14,11 +14,11 @@
 		"node": ">=20.0.0"
 	},
 	"dependencies": {
-		"@azure/cosmos": "^4.1.1",
-		"@azure/identity": "^4.4.1",
+		"@azure/cosmos": "^4.2.0",
+		"@azure/identity": "^4.5.0",
 		"@twin.org/core": "next",
 		"@twin.org/entity": "next",
-		"@twin.org/entity-storage-models": "0.0.1-next.13",
+		"@twin.org/entity-storage-models": "0.0.1-next.15",
 		"@twin.org/logging-models": "next",
 		"@twin.org/nameof": "next"
 	},
@@ -31,7 +31,7 @@
 			"import": "./dist/esm/index.mjs",
 			"types": "./dist/types/index.d.ts"
 		},
-		"./locales": "./locales"
+		"./locales/*.json": "./locales/*.json"
 	},
 	"files": [
 		"dist/cjs",