@twin.org/entity-storage-connector-file 0.0.1-next.8 → 0.0.1

package/dist/cjs/index.cjs

@@ -39,8 +39,6 @@ class FileEntityStorageConnector {
     /**
      * Create a new instance of FileEntityStorageConnector.
      * @param options The options for the connector.
-     * @param options.entitySchema The name of the entity schema.
-     * @param options.config The configuration for the connector.
      */
     constructor(options) {
         core.Guards.object(this.CLASS_NAME, "options", options);
@@ -114,48 +112,48 @@ class FileEntityStorageConnector {
      * Get an entity.
      * @param id The id of the entity to get, or the index value if secondaryIndex is set.
      * @param secondaryIndex Get the item using a secondary index.
+     * @param conditions The optional conditions to match for the entities.
      * @returns The object if it can be found or undefined.
      */
-    async get(id, secondaryIndex) {
+    async get(id, secondaryIndex, conditions) {
         core.Guards.stringValue(this.CLASS_NAME, "id", id);
-        const lookupKey = secondaryIndex ?? this._primaryKey.property;
         const store = await this.readStore();
-        const found = store?.find(entity => entity[lookupKey] === id);
-        if (found) {
-            return found;
-        }
-        return undefined;
+        const foundIndex = this.findItem(store, id, secondaryIndex, conditions);
+        return foundIndex === -1 ? undefined : store[foundIndex];
     }
     /**
      * Set an entity.
      * @param entity The entity to set.
+     * @param conditions The optional conditions to match for the entities.
      * @returns The id of the entity.
      */
-    async set(entity) {
-        core.Guards.object(this.CLASS_NAME, "entity", entity);
+    async set(entity$1, conditions) {
+        core.Guards.object(this.CLASS_NAME, "entity", entity$1);
+        entity.EntitySchemaHelper.validateEntity(entity$1, this.getSchema());
         const store = await this.readStore();
-        const existingIndex = store.findIndex(e => e[this._primaryKey.property] === entity[this._primaryKey.property]);
+        const existingIndex = this.findItem(store, entity$1[this._primaryKey.property], undefined, conditions);
         if (existingIndex >= 0) {
-            store[existingIndex] = entity;
+            store[existingIndex] = entity$1;
         }
         else {
-            store.push(entity);
+            store.push(entity$1);
         }
         await this.writeStore(store);
     }
     /**
      * Remove the entity.
      * @param id The id of the entity to remove.
+     * @param conditions The optional conditions to match for the entities.
      * @returns Nothing.
      */
-    async remove(id) {
+    async remove(id, conditions) {
         core.Guards.stringValue(this.CLASS_NAME, "id", id);
         const store = await this.readStore();
-        const index = store.findIndex(e => e[this._primaryKey.property] === id);
+        const index = this.findItem(store, id, undefined, conditions);
         if (index >= 0) {
             store.splice(index, 1);
+            await this.writeStore(store);
         }
-        await this.writeStore(store);
     }
     /**
      * Find all the entities which match the conditions.
@@ -180,7 +178,10 @@ class FileEntityStorageConnector {
                 if (entity.EntityConditions.check(allEntities[i], conditions) && entities.length < finalPageSize) {
                     entities.push(core.ObjectHelper.pick(allEntities[i], properties));
                     if (entities.length >= finalPageSize) {
-                        nextCursor = (i + 1).toString();
+                        if (i < allEntities.length - 1) {
+                            nextCursor = (i + 1).toString();
+                        }
+                        break;
                     }
                 }
             }
@@ -233,6 +234,51 @@ class FileEntityStorageConnector {
             return false;
         }
     }
+    /**
+     * Find the item in the store.
+     * @param store The store to search.
+     * @param id The id to search for.
+     * @param secondaryIndex The secondary index to search for.
+     * @param conditions The optional conditions to match for the entities.
+     * @returns The index of the item if found or -1.
+     * @internal
+     */
+    findItem(store, id, secondaryIndex, conditions) {
+        const finalConditions = [];
+        if (!core.Is.empty(secondaryIndex)) {
+            finalConditions.push({
+                property: secondaryIndex,
+                comparison: entity.ComparisonOperator.Equals,
+                value: id
+            });
+        }
+        if (core.Is.arrayValue(conditions)) {
+            // If we haven't added a secondary index condition we need to add the primary key condition.
+            if (finalConditions.length === 0) {
+                finalConditions.push({
+                    property: this._primaryKey.property,
+                    comparison: entity.ComparisonOperator.Equals,
+                    value: id
+                });
+            }
+            finalConditions.push(...conditions.map(c => ({
+                property: c.property,
+                comparison: entity.ComparisonOperator.Equals,
+                value: c.value
+            })));
+        }
+        if (finalConditions.length > 0) {
+            for (let i = 0; i < store.length; i++) {
+                if (entity.EntityConditions.check(store[i], { conditions: finalConditions })) {
+                    return i;
+                }
+            }
+        }
+        else {
+            return store.findIndex(e => e[this._primaryKey.property] === id);
+        }
+        return -1;
+    }
 }
 
 exports.FileEntityStorageConnector = FileEntityStorageConnector;

package/dist/esm/index.mjs

@@ -1,7 +1,7 @@
 import { mkdir, readFile, writeFile, access } from 'node:fs/promises';
 import path from 'node:path';
-import { Guards, BaseError, Coerce, ObjectHelper } from '@twin.org/core';
-import { EntitySchemaFactory, EntitySchemaHelper, EntitySorter, EntityConditions } from '@twin.org/entity';
+import { Guards, BaseError, Coerce, ObjectHelper, Is } from '@twin.org/core';
+import { EntitySchemaFactory, EntitySchemaHelper, EntitySorter, EntityConditions, ComparisonOperator } from '@twin.org/entity';
 import { LoggingConnectorFactory } from '@twin.org/logging-models';
 
 // Copyright 2024 IOTA Stiftung.
@@ -37,8 +37,6 @@ class FileEntityStorageConnector {
     /**
      * Create a new instance of FileEntityStorageConnector.
      * @param options The options for the connector.
-     * @param options.entitySchema The name of the entity schema.
-     * @param options.config The configuration for the connector.
      */
     constructor(options) {
         Guards.object(this.CLASS_NAME, "options", options);
@@ -112,27 +110,26 @@ class FileEntityStorageConnector {
      * Get an entity.
      * @param id The id of the entity to get, or the index value if secondaryIndex is set.
      * @param secondaryIndex Get the item using a secondary index.
+     * @param conditions The optional conditions to match for the entities.
      * @returns The object if it can be found or undefined.
      */
-    async get(id, secondaryIndex) {
+    async get(id, secondaryIndex, conditions) {
         Guards.stringValue(this.CLASS_NAME, "id", id);
-        const lookupKey = secondaryIndex ?? this._primaryKey.property;
         const store = await this.readStore();
-        const found = store?.find(entity => entity[lookupKey] === id);
-        if (found) {
-            return found;
-        }
-        return undefined;
+        const foundIndex = this.findItem(store, id, secondaryIndex, conditions);
+        return foundIndex === -1 ? undefined : store[foundIndex];
     }
     /**
      * Set an entity.
      * @param entity The entity to set.
+     * @param conditions The optional conditions to match for the entities.
      * @returns The id of the entity.
      */
-    async set(entity) {
+    async set(entity, conditions) {
         Guards.object(this.CLASS_NAME, "entity", entity);
+        EntitySchemaHelper.validateEntity(entity, this.getSchema());
         const store = await this.readStore();
-        const existingIndex = store.findIndex(e => e[this._primaryKey.property] === entity[this._primaryKey.property]);
+        const existingIndex = this.findItem(store, entity[this._primaryKey.property], undefined, conditions);
         if (existingIndex >= 0) {
             store[existingIndex] = entity;
         }
@@ -144,16 +141,17 @@ class FileEntityStorageConnector {
     /**
      * Remove the entity.
      * @param id The id of the entity to remove.
+     * @param conditions The optional conditions to match for the entities.
      * @returns Nothing.
      */
-    async remove(id) {
+    async remove(id, conditions) {
         Guards.stringValue(this.CLASS_NAME, "id", id);
         const store = await this.readStore();
-        const index = store.findIndex(e => e[this._primaryKey.property] === id);
+        const index = this.findItem(store, id, undefined, conditions);
         if (index >= 0) {
             store.splice(index, 1);
+            await this.writeStore(store);
         }
-        await this.writeStore(store);
     }
     /**
      * Find all the entities which match the conditions.
@@ -178,7 +176,10 @@ class FileEntityStorageConnector {
                 if (EntityConditions.check(allEntities[i], conditions) && entities.length < finalPageSize) {
                     entities.push(ObjectHelper.pick(allEntities[i], properties));
                     if (entities.length >= finalPageSize) {
-                        nextCursor = (i + 1).toString();
+                        if (i < allEntities.length - 1) {
+                            nextCursor = (i + 1).toString();
+                        }
+                        break;
                     }
                 }
             }
@@ -231,6 +232,51 @@ class FileEntityStorageConnector {
             return false;
         }
     }
+    /**
+     * Find the item in the store.
+     * @param store The store to search.
+     * @param id The id to search for.
+     * @param secondaryIndex The secondary index to search for.
+     * @param conditions The optional conditions to match for the entities.
+     * @returns The index of the item if found or -1.
+     * @internal
+     */
+    findItem(store, id, secondaryIndex, conditions) {
+        const finalConditions = [];
+        if (!Is.empty(secondaryIndex)) {
+            finalConditions.push({
+                property: secondaryIndex,
+                comparison: ComparisonOperator.Equals,
+                value: id
+            });
+        }
+        if (Is.arrayValue(conditions)) {
+            // If we haven't added a secondary index condition we need to add the primary key condition.
+            if (finalConditions.length === 0) {
+                finalConditions.push({
+                    property: this._primaryKey.property,
+                    comparison: ComparisonOperator.Equals,
+                    value: id
+                });
+            }
+            finalConditions.push(...conditions.map(c => ({
+                property: c.property,
+                comparison: ComparisonOperator.Equals,
+                value: c.value
+            })));
+        }
+        if (finalConditions.length > 0) {
+            for (let i = 0; i < store.length; i++) {
+                if (EntityConditions.check(store[i], { conditions: finalConditions })) {
+                    return i;
+                }
+            }
+        }
+        else {
+            return store.findIndex(e => e[this._primaryKey.property] === id);
+        }
+        return -1;
+    }
 }
 
 export { FileEntityStorageConnector };

package/dist/types/fileEntityStorageConnector.d.ts

@@ -1,6 +1,6 @@
 import { type EntityCondition, type IEntitySchema, type SortDirection } from "@twin.org/entity";
 import type { IEntityStorageConnector } from "@twin.org/entity-storage-models";
-import type { IFileEntityStorageConnectorConfig } from "./models/IFileEntityStorageConnectorConfig";
+import type { IFileEntityStorageConnectorConstructorOptions } from "./models/IFileEntityStorageConnectorConstructorOptions";
 /**
  * Class for performing entity storage operations in file.
  */
@@ -12,13 +12,8 @@ export declare class FileEntityStorageConnector<T = unknown> implements IEntityS
     /**
      * Create a new instance of FileEntityStorageConnector.
      * @param options The options for the connector.
-     * @param options.entitySchema The name of the entity schema.
-     * @param options.config The configuration for the connector.
      */
-    constructor(options: {
-        entitySchema: string;
-        config: IFileEntityStorageConnectorConfig;
-    });
+    constructor(options: IFileEntityStorageConnectorConstructorOptions);
     /**
      * Bootstrap the connector by creating and initializing any resources it needs.
      * @param nodeLoggingConnectorType The node logging connector type, defaults to "node-logging".
@@ -34,21 +29,33 @@ export declare class FileEntityStorageConnector<T = unknown> implements IEntityS
      * Get an entity.
      * @param id The id of the entity to get, or the index value if secondaryIndex is set.
      * @param secondaryIndex Get the item using a secondary index.
+     * @param conditions The optional conditions to match for the entities.
      * @returns The object if it can be found or undefined.
      */
-    get(id: string, secondaryIndex?: keyof T): Promise<T | undefined>;
+    get(id: string, secondaryIndex?: keyof T, conditions?: {
+        property: keyof T;
+        value: unknown;
+    }[]): Promise<T | undefined>;
     /**
      * Set an entity.
      * @param entity The entity to set.
+     * @param conditions The optional conditions to match for the entities.
      * @returns The id of the entity.
      */
-    set(entity: T): Promise<void>;
+    set(entity: T, conditions?: {
+        property: keyof T;
+        value: unknown;
+    }[]): Promise<void>;
     /**
      * Remove the entity.
      * @param id The id of the entity to remove.
+     * @param conditions The optional conditions to match for the entities.
      * @returns Nothing.
      */
-    remove(id: string): Promise<void>;
+    remove(id: string, conditions?: {
+        property: keyof T;
+        value: unknown;
+    }[]): Promise<void>;
     /**
      * Find all the entities which match the conditions.
      * @param conditions The conditions to match for the entities.

package/dist/types/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./fileEntityStorageConnector";
 export * from "./models/IFileEntityStorageConnectorConfig";
+export * from "./models/IFileEntityStorageConnectorConstructorOptions";

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

@@ -0,0 +1,14 @@
+import type { IFileEntityStorageConnectorConfig } from "./IFileEntityStorageConnectorConfig";
+/**
+ * Options for the File Entity Storage Connector constructor.
+ */
+export interface IFileEntityStorageConnectorConstructorOptions {
+    /**
+     * The name of the entity schema.
+     */
+    entitySchema: string;
+    /**
+     * The configuration for the connector.
+     */
+    config: IFileEntityStorageConnectorConfig;
+}

package/docs/changelog.md

@@ -1,5 +1,109 @@
 # @twin.org/entity-storage-connector-file - Changelog
 
-## v0.0.1-next.8
+## 0.0.1 (2025-07-04)
+
+
+### Features
+
+* add production release automation ([1eb4c8e](https://github.com/twinfoundation/entity-storage/commit/1eb4c8ee3eb099defdfc2d063ae44935276dcae8))
+* release to production ([a309051](https://github.com/twinfoundation/entity-storage/commit/a3090519adebf7943232b4df12e4c6bd5afe7eed))
+* update dependencies ([7ccc0c4](https://github.com/twinfoundation/entity-storage/commit/7ccc0c429125d073dc60b3de6cf101abc8cc6cba))
+* use shared store mechanism ([#34](https://github.com/twinfoundation/entity-storage/issues/34)) ([68b6b71](https://github.com/twinfoundation/entity-storage/commit/68b6b71e7a96d7d016cd57bfff36775b56bf3f93))
+
+
+### Bug Fixes
+
+* query params force coercion ([dd6aa87](https://github.com/twinfoundation/entity-storage/commit/dd6aa87efdfb60bab7d6756a86888863c45c51a7))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from ^0.0.0 to ^0.0.1
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from ^0.0.0 to ^0.0.1
+
+## [0.0.1-next.31](https://github.com/twinfoundation/entity-storage/compare/entity-storage-connector-file-v0.0.1-next.30...entity-storage-connector-file-v0.0.1-next.31) (2025-06-20)
+
+
+### Bug Fixes
+
+* query params force coercion ([dd6aa87](https://github.com/twinfoundation/entity-storage/commit/dd6aa87efdfb60bab7d6756a86888863c45c51a7))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.0.1-next.30 to 0.0.1-next.31
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.0.1-next.30 to 0.0.1-next.31
+
+## [0.0.1-next.30](https://github.com/twinfoundation/entity-storage/compare/entity-storage-connector-file-v0.0.1-next.29...entity-storage-connector-file-v0.0.1-next.30) (2025-06-12)
+
+
+### Features
+
+* update dependencies ([7ccc0c4](https://github.com/twinfoundation/entity-storage/commit/7ccc0c429125d073dc60b3de6cf101abc8cc6cba))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.0.1-next.29 to 0.0.1-next.30
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.0.1-next.29 to 0.0.1-next.30
+
+## [0.0.1-next.29](https://github.com/twinfoundation/entity-storage/compare/entity-storage-connector-file-v0.0.1-next.28...entity-storage-connector-file-v0.0.1-next.29) (2025-04-17)
+
+
+### Features
+
+* use shared store mechanism ([#34](https://github.com/twinfoundation/entity-storage/issues/34)) ([68b6b71](https://github.com/twinfoundation/entity-storage/commit/68b6b71e7a96d7d016cd57bfff36775b56bf3f93))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.0.1-next.28 to 0.0.1-next.29
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.0.1-next.28 to 0.0.1-next.29
+
+## [0.0.1-next.28](https://github.com/twinfoundation/entity-storage/compare/entity-storage-connector-file-v0.0.1-next.27...entity-storage-connector-file-v0.0.1-next.28) (2025-04-09)
+
+
+### Miscellaneous Chores
+
+* **entity-storage-connector-file:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.0.1-next.27 to 0.0.1-next.28
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.0.1-next.27 to 0.0.1-next.28
+
+## [0.0.1-next.27](https://github.com/twinfoundation/entity-storage/compare/entity-storage-connector-file-v0.0.1-next.26...entity-storage-connector-file-v0.0.1-next.27) (2025-03-28)
+
+
+### Miscellaneous Chores
+
+* **entity-storage-connector-file:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/entity-storage-models bumped from 0.0.1-next.26 to 0.0.1-next.27
+  * devDependencies
+    * @twin.org/entity-storage-connector-memory bumped from 0.0.1-next.26 to 0.0.1-next.27
+
+## v0.0.1-next.26
 
 - Initial Release

package/docs/reference/classes/FileEntityStorageConnector.md

@@ -4,7 +4,9 @@ Class for performing entity storage operations in file.
 
 ## Type Parameters
 
-• **T** = `unknown`
+### T
+
+`T` = `unknown`
 
 ## Implements
 
@@ -12,29 +14,23 @@ Class for performing entity storage operations in file.
 
 ## Constructors
 
-### new FileEntityStorageConnector()
+### Constructor
 
-> **new FileEntityStorageConnector**\<`T`\>(`options`): [`FileEntityStorageConnector`](FileEntityStorageConnector.md)\<`T`\>
+> **new FileEntityStorageConnector**\<`T`\>(`options`): `FileEntityStorageConnector`\<`T`\>
 
 Create a new instance of FileEntityStorageConnector.
 
 #### Parameters
 
-• **options**
-
-The options for the connector.
-
-• **options.entitySchema**: `string`
-
-The name of the entity schema.
+##### options
 
-• **options.config**: [`IFileEntityStorageConnectorConfig`](../interfaces/IFileEntityStorageConnectorConfig.md)
+[`IFileEntityStorageConnectorConstructorOptions`](../interfaces/IFileEntityStorageConnectorConstructorOptions.md)
 
-The configuration for the connector.
+The options for the connector.
 
 #### Returns
 
-[`FileEntityStorageConnector`](FileEntityStorageConnector.md)\<`T`\>
+`FileEntityStorageConnector`\<`T`\>
 
 ## Properties
 
@@ -52,13 +48,15 @@ Runtime name for the class.
 
 ### bootstrap()
 
-> **bootstrap**(`nodeLoggingConnectorType`?): `Promise`\<`boolean`\>
+> **bootstrap**(`nodeLoggingConnectorType?`): `Promise`\<`boolean`\>
 
 Bootstrap the connector by creating and initializing any resources it needs.
 
 #### Parameters
 
-• **nodeLoggingConnectorType?**: `string`
+##### nodeLoggingConnectorType?
+
+`string`
 
 The node logging connector type, defaults to "node-logging".
 
@@ -76,13 +74,13 @@ True if the bootstrapping process was successful.
 
 ### getSchema()
 
-> **getSchema**(): `IEntitySchema`\<`unknown`\>
+> **getSchema**(): `IEntitySchema`
 
 Get the schema for the entities.
 
 #### Returns
 
-`IEntitySchema`\<`unknown`\>
+`IEntitySchema`
 
 The schema for the entities.
 
@@ -94,20 +92,30 @@ The schema for the entities.
 
 ### get()
 
-> **get**(`id`, `secondaryIndex`?): `Promise`\<`undefined` \| `T`\>
+> **get**(`id`, `secondaryIndex?`, `conditions?`): `Promise`\<`undefined` \| `T`\>
 
 Get an entity.
 
 #### 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`[]
+
+The optional conditions to match for the entities.
+
 #### Returns
 
 `Promise`\<`undefined` \| `T`\>
@@ -122,16 +130,24 @@ The object if it can be found or undefined.
 
 ### set()
 
-> **set**(`entity`): `Promise`\<`void`\>
+> **set**(`entity`, `conditions?`): `Promise`\<`void`\>
 
 Set an entity.
 
 #### Parameters
 
-• **entity**: `T`
+##### entity
+
+`T`
 
 The entity to set.
 
+##### conditions?
+
+`object`[]
+
+The optional conditions to match for the entities.
+
 #### Returns
 
 `Promise`\<`void`\>
@@ -146,16 +162,24 @@ The id of the entity.
 
 ### remove()
 
-> **remove**(`id`): `Promise`\<`void`\>
+> **remove**(`id`, `conditions?`): `Promise`\<`void`\>
 
 Remove the entity.
 
 #### Parameters
 
-• **id**: `string`
+##### id
+
+`string`
 
 The id of the entity to remove.
 
+##### conditions?
+
+`object`[]
+
+The optional conditions to match for the entities.
+
 #### Returns
 
 `Promise`\<`void`\>
@@ -170,51 +194,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`\>[]
-
-The entities, which can be partial if a limited keys list was provided.
-
-##### cursor?
-
-> `optional` **cursor**: `string`
-
-An optional cursor, when defined can be used to call find to get more entities.
-
 #### Implementation of
 
 `IEntityStorageConnector.query`

package/docs/reference/index.md

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

package/docs/reference/interfaces/IFileEntityStorageConnectorConstructorOptions.md

@@ -0,0 +1,19 @@
+# Interface: IFileEntityStorageConnectorConstructorOptions
+
+Options for the File Entity Storage Connector constructor.
+
+## Properties
+
+### entitySchema
+
+> **entitySchema**: `string`
+
+The name of the entity schema.
+
+***
+
+### config
+
+> **config**: [`IFileEntityStorageConnectorConfig`](IFileEntityStorageConnectorConfig.md)
+
+The configuration for the connector.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/entity-storage-connector-file",
-	"version": "0.0.1-next.8",
+	"version": "0.0.1",
 	"description": "Entity Storage connector implementation using file storage",
 	"repository": {
 		"type": "git",
@@ -14,22 +14,22 @@
 		"node": ">=20.0.0"
 	},
 	"dependencies": {
-		"@twin.org/core": "next",
-		"@twin.org/entity": "next",
-		"@twin.org/entity-storage-models": "0.0.1-next.8",
-		"@twin.org/logging-models": "next",
-		"@twin.org/nameof": "next"
+		"@twin.org/core": "^0.0.1",
+		"@twin.org/entity": "^0.0.1",
+		"@twin.org/entity-storage-models": "^0.0.1",
+		"@twin.org/logging-models": "^0.0.1",
+		"@twin.org/nameof": "^0.0.1"
 	},
 	"main": "./dist/cjs/index.cjs",
 	"module": "./dist/esm/index.mjs",
 	"types": "./dist/types/index.d.ts",
 	"exports": {
 		".": {
+			"types": "./dist/types/index.d.ts",
 			"require": "./dist/cjs/index.cjs",
-			"import": "./dist/esm/index.mjs",
-			"types": "./dist/types/index.d.ts"
+			"import": "./dist/esm/index.mjs"
 		},
-		"./locales": "./locales"
+		"./locales/*.json": "./locales/*.json"
 	},
 	"files": [
 		"dist/cjs",