@twin.org/logging-models 0.0.1-next.2

package/docs/reference/interfaces/ILoggingConnector.md

@@ -0,0 +1,80 @@
+# Interface: ILoggingConnector
+
+Interface describing a logging connector.
+
+## Extends
+
+- `IComponent`
+
+## Methods
+
+### log()
+
+> **log**(`logEntry`): `Promise`\<`void`\>
+
+Log an entry to the connector.
+
+#### Parameters
+
+• **logEntry**: [`ILogEntry`](ILogEntry.md)
+
+The entry to log.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Nothing.
+
+***
+
+### query()
+
+> **query**(`conditions`?, `sortProperties`?, `properties`?, `cursor`?, `pageSize`?): `Promise`\<`object`\>
+
+Query the log entries.
+
+#### Parameters
+
+• **conditions?**: `EntityCondition`\<[`ILogEntry`](ILogEntry.md)\>
+
+The conditions to match for the entities.
+
+• **sortProperties?**: `object`[]
+
+The optional sort order.
+
+• **properties?**: keyof [`ILogEntry`](ILogEntry.md)[]
+
+The optional keys to return, defaults to all.
+
+• **cursor?**: `string`
+
+The cursor to request the next page of entities.
+
+• **pageSize?**: `number`
+
+The maximum number of entities in a page.
+
+#### Returns
+
+`Promise`\<`object`\>
+
+All the entities for the storage matching the conditions,
+and a cursor which can be used to request more entities.
+
+##### entities
+
+> **entities**: `Partial`\<[`ILogEntry`](ILogEntry.md)\>[]
+
+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.
+
+#### Throws
+
+NotImplementedError if the implementation does not support retrieval.

package/docs/reference/interfaces/ILoggingCreateRequest.md

@@ -0,0 +1,11 @@
+# Interface: ILoggingCreateRequest
+
+Create a new log entry.
+
+## Properties
+
+### body
+
+> **body**: [`ILogEntry`](ILogEntry.md)
+
+The data to be used in the create.

package/docs/reference/interfaces/ILoggingLevelsConfig.md

@@ -0,0 +1,11 @@
+# Interface: ILoggingLevelsConfig
+
+Configuration for the logging connectors to specify the levels to display.
+
+## Properties
+
+### levels?
+
+> `optional` **levels**: [`LogLevel`](../type-aliases/LogLevel.md)[]
+
+The log levels to display, will default to all.

package/docs/reference/interfaces/ILoggingListRequest.md

@@ -0,0 +1,47 @@
+# Interface: ILoggingListRequest
+
+Get the a list of the log entries.
+
+## Properties
+
+### query
+
+> **query**: `object`
+
+The query parameters.
+
+#### level?
+
+> `optional` **level**: [`LogLevel`](../type-aliases/LogLevel.md)
+
+The level of the log entries to retrieve.
+
+#### source?
+
+> `optional` **source**: `string`
+
+The source of the log entries to retrieve.
+
+#### timeStart?
+
+> `optional` **timeStart**: `number`
+
+The start time of the metrics to retrieve as a timestamp in ms.
+
+#### timeEnd?
+
+> `optional` **timeEnd**: `number`
+
+The end time of the metrics to retrieve as a timestamp in ms.
+
+#### cursor?
+
+> `optional` **cursor**: `string`
+
+The optional cursor to get next chunk.
+
+#### pageSize?
+
+> `optional` **pageSize**: `number`
+
+The maximum number of entities in a page.

package/docs/reference/interfaces/ILoggingListResponse.md

@@ -0,0 +1,23 @@
+# Interface: ILoggingListResponse
+
+Response for log entry list request.
+
+## Properties
+
+### body
+
+> **body**: `object`
+
+The response payload.
+
+#### entities
+
+> **entities**: [`ILogEntry`](ILogEntry.md)[]
+
+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.

package/docs/reference/type-aliases/LogLevel.md

@@ -0,0 +1,5 @@
+# Type Alias: LogLevel
+
+> **LogLevel**: `"info"` \| `"error"` \| `"warn"` \| `"trace"` \| `"debug"`
+
+Log level.

package/docs/reference/variables/LoggingConnectorFactory.md

@@ -0,0 +1,5 @@
+# Variable: LoggingConnectorFactory
+
+> `const` **LoggingConnectorFactory**: `Factory`\<[`ILoggingConnector`](../interfaces/ILoggingConnector.md)\>
+
+Factory for creating logging connectors.

package/locales/en.json

@@ -0,0 +1,3 @@
+{
+	"error": {}
+}

package/package.json

@@ -0,0 +1,65 @@
+{
+	"name": "@twin.org/logging-models",
+	"version": "0.0.1-next.2",
+	"description": "Models which define the structure of the logging connectors and services",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/twinfoundation/logging.git",
+		"directory": "packages/logging-models"
+	},
+	"author": "martyn.janes@iota.org",
+	"license": "Apache-2.0",
+	"type": "module",
+	"engines": {
+		"node": ">=20.0.0"
+	},
+	"scripts": {
+		"clean": "rimraf dist coverage docs/reference",
+		"build": "tspc",
+		"test": "vitest --run --config ./vitest.config.ts --no-cache",
+		"coverage": "vitest --run --coverage --config ./vitest.config.ts --no-cache",
+		"bundle:esm": "rollup --config rollup.config.mjs --environment MODULE:esm",
+		"bundle:cjs": "rollup --config rollup.config.mjs --environment MODULE:cjs",
+		"bundle": "npm run bundle:esm && npm run bundle:cjs",
+		"docs:clean": "rimraf docs/reference",
+		"docs:generate": "typedoc",
+		"docs": "npm run docs:clean && npm run docs:generate",
+		"dist": "npm run clean && npm run build && npm run test && npm run bundle && npm run docs"
+	},
+	"dependencies": {
+		"@twin.org/core": "next",
+		"@twin.org/entity": "next",
+		"@twin.org/nameof": "next"
+	},
+	"devDependencies": {
+		"@twin.org/nameof-transformer": "next",
+		"@vitest/coverage-v8": "2.1.1",
+		"copyfiles": "2.4.1",
+		"rimraf": "6.0.1",
+		"rollup": "4.21.3",
+		"rollup-plugin-typescript2": "0.36.0",
+		"ts-patch": "3.2.1",
+		"typedoc": "0.26.7",
+		"typedoc-plugin-markdown": "4.2.7",
+		"typescript": "5.6.2",
+		"vitest": "2.1.1"
+	},
+	"main": "./dist/cjs/index.cjs",
+	"module": "./dist/esm/index.mjs",
+	"types": "./dist/types/index.d.ts",
+	"exports": {
+		".": {
+			"require": "./dist/cjs/index.cjs",
+			"import": "./dist/esm/index.mjs",
+			"types": "./dist/types/index.d.ts"
+		},
+		"./locales": "./locales"
+	},
+	"files": [
+		"dist/cjs",
+		"dist/esm",
+		"dist/types",
+		"locales",
+		"docs"
+	]
+}