@twin.org/entity-storage-connector-mysql 0.0.1-next.18

package/docs/reference/classes/MySqlEntityStorageConnector.md

@@ -0,0 +1,254 @@
+# Class: MySqlEntityStorageConnector\<T\>
+
+Class for performing entity storage operations using MySql.
+
+## Type Parameters
+
+• **T** = `unknown`
+
+## Implements
+
+- `IEntityStorageConnector`\<`T`\>
+
+## Constructors
+
+### new MySqlEntityStorageConnector()
+
+> **new MySqlEntityStorageConnector**\<`T`\>(`options`): [`MySqlEntityStorageConnector`](MySqlEntityStorageConnector.md)\<`T`\>
+
+Create a new instance of MySqlEntityStorageConnector.
+
+#### Parameters
+
+##### options
+
+[`IMySqlEntityStorageConnectorConstructorOptions`](../interfaces/IMySqlEntityStorageConnectorConstructorOptions.md)
+
+The options for the connector.
+
+#### Returns
+
+[`MySqlEntityStorageConnector`](MySqlEntityStorageConnector.md)\<`T`\>
+
+## Properties
+
+### CLASS\_NAME
+
+> `readonly` **CLASS\_NAME**: `string`
+
+Runtime name for the class.
+
+#### Implementation of
+
+`IEntityStorageConnector.CLASS_NAME`
+
+## Methods
+
+### bootstrap()
+
+> **bootstrap**(`nodeLoggingConnectorType`?): `Promise`\<`boolean`\>
+
+Initialize the MySql environment.
+
+#### Parameters
+
+##### nodeLoggingConnectorType?
+
+`string`
+
+Optional type of the logging connector.
+
+#### Returns
+
+`Promise`\<`boolean`\>
+
+A promise that resolves to a boolean indicating success.
+
+#### Implementation of
+
+`IEntityStorageConnector.bootstrap`
+
+***
+
+### getSchema()
+
+> **getSchema**(): `IEntitySchema`
+
+Get the schema for the entities.
+
+#### Returns
+
+`IEntitySchema`
+
+The schema for the entities.
+
+#### Implementation of
+
+`IEntityStorageConnector.getSchema`
+
+***
+
+### get()
+
+> **get**(`id`, `secondaryIndex`?, `conditions`?): `Promise`\<`undefined` \| `T`\>
+
+Get an entity from MySql.
+
+#### Parameters
+
+##### id
+
+`string`
+
+The id of the entity to get, or the index value if secondaryIndex is set.
+
+##### secondaryIndex?
+
+keyof `T`
+
+Get the item using a secondary index.
+
+##### conditions?
+
+`object`[]
+
+The optional conditions to match for the entities.
+
+#### Returns
+
+`Promise`\<`undefined` \| `T`\>
+
+The object if it can be found or undefined.
+
+#### Implementation of
+
+`IEntityStorageConnector.get`
+
+***
+
+### set()
+
+> **set**(`entity`, `conditions`?): `Promise`\<`void`\>
+
+Set an entity.
+
+#### Parameters
+
+##### entity
+
+`T`
+
+The entity to set.
+
+##### conditions?
+
+`object`[]
+
+The optional conditions to match for the entities.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+The id of the entity.
+
+#### Implementation of
+
+`IEntityStorageConnector.set`
+
+***
+
+### remove()
+
+> **remove**(`id`, `conditions`?): `Promise`\<`void`\>
+
+Remove the entity.
+
+#### Parameters
+
+##### id
+
+`string`
+
+The id of the entity to remove.
+
+##### conditions?
+
+`object`[]
+
+The optional conditions to match for the entities.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Nothing.
+
+#### Implementation of
+
+`IEntityStorageConnector.remove`
+
+***
+
+### query()
+
+> **query**(`conditions`?, `sortProperties`?, `properties`?, `cursor`?, `pageSize`?): `Promise`\<\{ `entities`: `Partial`\<`T`\>[]; `cursor`: `string`; \}\>
+
+Find all the entities which match the conditions.
+
+#### Parameters
+
+##### conditions?
+
+`EntityCondition`\<`T`\>
+
+The conditions to match for the entities.
+
+##### sortProperties?
+
+`object`[]
+
+The optional sort order.
+
+##### properties?
+
+keyof `T`[]
+
+The optional properties to return, defaults to all.
+
+##### cursor?
+
+`string`
+
+The cursor to request the next page of entities.
+
+##### pageSize?
+
+`number`
+
+The suggested number of entities to return in each chunk, in some scenarios can return a different amount.
+
+#### Returns
+
+`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.
+
+#### Implementation of
+
+`IEntityStorageConnector.query`
+
+***
+
+### tableDrop()
+
+> **tableDrop**(): `Promise`\<`void`\>
+
+Drop the table.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Nothing.

package/docs/reference/index.md

@@ -0,0 +1,10 @@
+# @twin.org/entity-storage-connector-mysql
+
+## Classes
+
+- [MySqlEntityStorageConnector](classes/MySqlEntityStorageConnector.md)
+
+## Interfaces
+
+- [IMySqlEntityStorageConnectorConfig](interfaces/IMySqlEntityStorageConnectorConfig.md)
+- [IMySqlEntityStorageConnectorConstructorOptions](interfaces/IMySqlEntityStorageConnectorConstructorOptions.md)

package/docs/reference/interfaces/IMySqlEntityStorageConnectorConfig.md

@@ -0,0 +1,51 @@
+# Interface: IMySqlEntityStorageConnectorConfig
+
+Configuration for the MySql Entity Storage Connector.
+
+## Properties
+
+### host
+
+> **host**: `string`
+
+The host for the MySql instance.
+
+***
+
+### port?
+
+> `optional` **port**: `number`
+
+The port for the MySql instance.
+
+***
+
+### user
+
+> **user**: `string`
+
+The user for the MySql instance.
+
+***
+
+### password
+
+> **password**: `string`
+
+The password for the MySql instance.
+
+***
+
+### database
+
+> **database**: `string`
+
+The name of the database to be used.
+
+***
+
+### table
+
+> **table**: `string`
+
+The name of the table to be used.

package/docs/reference/interfaces/IMySqlEntityStorageConnectorConstructorOptions.md

@@ -0,0 +1,33 @@
+# Interface: IMySqlEntityStorageConnectorConstructorOptions
+
+The options for the MySql 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**: [`IMySqlEntityStorageConnectorConfig`](IMySqlEntityStorageConnectorConfig.md)
+
+The configuration for the connector.

package/locales/en.json

@@ -0,0 +1,21 @@
+{
+	"info": {
+		"mysqlEntityStorageConnector": {
+			"databaseCreating": "Database \"{databaseName}\" creating",
+			"databaseExists": "Database \"{databaseName}\" created or it already exists",
+			"tableExists": "Database \"{tableName}\" created or it already exists"
+		}
+	},
+	"error": {
+		"mysqlEntityStorageConnector": {
+			"setFailed": "Unable to set entity \"{id}\"",
+			"getFailed": "Unable to get entity \"{id}\"",
+			"removeFailed": "Unable to remove entity \"{id}\"",
+			"queryFailed": "The query failed",
+			"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"
+		}
+	}
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+	"name": "@twin.org/entity-storage-connector-mysql",
+	"version": "0.0.1-next.18",
+	"description": "Entity Storage connector implementation using MySQL storage",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/twinfoundation/entity-storage.git",
+		"directory": "packages/entity-storage-connector-mysql"
+	},
+	"author": "adrian.sanchez.sequeira@iota.org",
+	"license": "Apache-2.0",
+	"type": "module",
+	"engines": {
+		"node": ">=20.0.0"
+	},
+	"dependencies": {
+		"@twin.org/core": "next",
+		"@twin.org/entity": "next",
+		"@twin.org/entity-storage-models": "0.0.1-next.18",
+		"@twin.org/logging-models": "next",
+		"@twin.org/nameof": "next",
+		"mysql2": "^3.12.0"
+	},
+	"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"
+		},
+		"./locales/*.json": "./locales/*.json"
+	},
+	"files": [
+		"dist/cjs",
+		"dist/esm",
+		"dist/types",
+		"locales",
+		"docs"
+	]
+}