@twin.org/node-core 0.0.2-next.25 → 0.0.2-next.27

package/docs/reference/interfaces/INodeOptions.md

@@ -26,6 +26,18 @@ The version of the server, defaults to the current version.
 
 ***
 
+### envVars?
+
+> `optional` **envVars**: `object`
+
+Additional environment variables to set.
+
+#### Index Signature
+
+\[`key`: `string`\]: `string`
+
+***
+
 ### envFilenames?
 
 > `optional` **envFilenames**: `string`[]
@@ -38,7 +50,7 @@ Additional environment variable filenames to load, defaults to .env.
 
 > `optional` **envPrefix**: `string`
 
-The prefix for environment variables, defaults to "TWIN_NODE_".
+The prefix for environment variables, defaults to "TWIN_".
 
 ***
 
@@ -175,3 +187,11 @@ Method to extend the engine server with any additional options.
 
 The state storage to use for the engine.
 If not provided, a default file-based state storage will be used.
+
+***
+
+### disableProcessExitOnFailure?
+
+> `optional` **disableProcessExitOnFailure**: `boolean`
+
+Disables process.exit calls on fatal errors and throws instead.

package/docs/reference/interfaces/IProtocolHandlerResult.md

@@ -0,0 +1,19 @@
+# Interface: IProtocolHandlerResult
+
+The result from a protocol handler.
+
+## Properties
+
+### resolvedPath
+
+> **resolvedPath**: `string`
+
+The resolved path to the module file.
+
+***
+
+### cached
+
+> **cached**: `boolean`
+
+Whether the module was cached.

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

@@ -0,0 +1,5 @@
+# Type Alias: ModuleProtocol
+
+> **ModuleProtocol** = *typeof* [`ModuleProtocol`](../variables/ModuleProtocol.md)\[keyof *typeof* [`ModuleProtocol`](../variables/ModuleProtocol.md)\]
+
+The protocol type for a module.

package/docs/reference/variables/ModuleProtocol.md

@@ -0,0 +1,37 @@
+# Variable: ModuleProtocol
+
+> `const` **ModuleProtocol**: `object`
+
+The protocol types for modules.
+
+## Type Declaration
+
+### Local
+
+> `readonly` **Local**: `"local"` = `"local"`
+
+Local module (starts with . or / or file://).
+
+### Npm
+
+> `readonly` **Npm**: `"npm"` = `"npm"`
+
+NPM package (starts with npm:).
+
+### Https
+
+> `readonly` **Https**: `"https"` = `"https"`
+
+HTTPS URL (starts with https://).
+
+### Http
+
+> `readonly` **Http**: `"http"` = `"http"`
+
+HTTP URL (starts with http://).
+
+### Default
+
+> `readonly` **Default**: `"default"` = `"default"`
+
+Default/standard module resolution.

package/docs/reference/variables/NodeFeatures.md

@@ -6,20 +6,20 @@ The features that can be enabled on the node.
 
 ## Type Declaration
 
-### NodeIdentity
+### NodeId
 
-> `readonly` **NodeIdentity**: `"node-identity"` = `"node-identity"`
+> `readonly` **NodeId**: `"node-identity"` = `"node-identity"`
 
-NodeIdentity - generates an identity for the node if not provided in config.
+NodeId - generates an identity for the node if not provided in config.
 
-### NodeUser
+### NodeAdminUser
 
-> `readonly` **NodeUser**: `"node-user"` = `"node-user"`
+> `readonly` **NodeAdminUser**: `"node-admin-user"` = `"node-admin-user"`
 
-NodeUser - generates a user for the node if not provided in config.
+NodeAdminUser - generates an admin user for the node if not provided in config.
 
 ### NodeWallet
 
 > `readonly` **NodeWallet**: `"node-wallet"` = `"node-wallet"`
 
-NodeWallet - generates a wallet for the node and funds it when there is a faucet available.
+NodeWallet - generates wallets for any identities that need them.

package/locales/en.json

@@ -2,7 +2,11 @@
 	"error": {
 		"node": {
 			"storageFileRootNotSet": "{storageFileRoot} is not set, the server will not start without it, please set it in the shell or create a .env file",
-			"extensionLoadingError": "Failed to load extension \"{extension}\""
+			"extensionLoadingError": "Failed to load extension \"{extension}\"",
+			"insecureProtocol": "Cannot load extension from insecure protocol: {protocol}. Only HTTPS is allowed for remote extensions.",
+			"extensionDownloadFailed": "Failed to download extension from {url}",
+			"extensionNpmInstallFailed": "Failed to install npm extension: {package}",
+			"extensionSizeLimitExceeded": "Extension download size exceeds limit: {size} bytes > {limit} bytes"
 		}
 	},
 	"node": {
@@ -11,12 +15,13 @@
 		"existingMnemonic": "Mnemonic already exists",
 		"fundingWallet": "Funding wallet \"{address}\"",
 		"fundedWallet": "Wallet already funded",
-		"generatingNodeIdentity": "Generating node identity",
-		"existingNodeIdentity": "Node identity already exists \"{identity}\"",
-		"createdNodeIdentity": "Node identity created \"{identity}\"",
+		"processingIdentity": "Processing identity of type \"{identityType}\"",
+		"generatingIdentity": "Generating identity of type \"{identityType}\"",
+		"existingIdentity": "Identity already exists \"{identity}\"",
+		"createdIdentity": "Identity created \"{identity}\"",
 		"identityExplorer": "Identity explorer \"{url}\"",
-		"creatingNodeUser": "Creating node user \"{email}\"",
-		"existingNodeUser": "Node user already exists \"{email}\"",
+		"creatingUser": "Creating user \"{email}\"",
+		"existingUser": "User already exists \"{email}\"",
 		"creatingAuthKey": "Creating authentication key \"{keyName}\"",
 		"existingAuthKey": "Authentication key already exists \"{keyName}\"",
 		"addingVerificationMethod": "Adding {title} verification method \"{methodId}\"",
@@ -29,7 +34,7 @@
 		"existingSynchronisedStorageBlobEncryptionKey": "Synchronised storage blob encryption key already exists \"{keyName}\"",
 		"creatingUserProfile": "Creating user profile \"{identity}\"",
 		"existingUserProfile": "User profile already exists \"{identity}\"",
-		"nodeIdentity": "Node identity \"{identity}\"",
+		"nodeId": "Node identity \"{identity}\"",
 		"nodeAdminUserEmail": "Node Admin User Email \"{email}\"",
 		"nodeAdminUserPassword": "Node Admin User Password \"{password}\"",
 		"extensionLoading": "Loading Extension",
@@ -37,6 +42,13 @@
 		"extensionInitialisingEngineServer": "Initialising engine server for extension \"{extension}\"",
 		"extensionShutdown": "Shutdown extension \"{extension}\"",
 		"extendingEngine": "Extending Engine",
-		"extendingEngineServer": "Extending Engine Server"
+		"extendingEngineServer": "Extending Engine Server",
+		"extensionSecurityWarning": "SECURITY WARNING: Loading extension from external URL: {url}",
+		"extensionNpmInstalling": "Installing npm extension",
+		"extensionHttpsDownloading": "Downloading HTTPS extension",
+		"extensionCacheExpired": "Cache expired for extension: {url}",
+		"extensionForceRefresh": "Force refresh enabled for extension: {url}",
+		"createdTenantId": "Created tenant id \"{identity}\" with api key \"{apiKey}\"",
+		"existingTenantId": "Existing tenant id \"{identity}\""
 	}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/node-core",
-	"version": "0.0.2-next.25",
+	"version": "0.0.2-next.27",
 	"description": "TWIN Node Core for serving APIs using the specified configuration",
 	"repository": {
 		"type": "git",
@@ -13,10 +13,27 @@
 	"engines": {
 		"node": ">=20.0.0"
 	},
+	"scripts": {
+		"clean": "rimraf dist coverage docs/reference",
+		"build": "tspc",
+		"dev": "nodemon --watch src --ext ts --exec \"npm run build\"",
+		"merge-locales": "merge-locales",
+		"test": "vitest --run --config ./vitest.config.ts --no-cache",
+		"test:build": "tspc -p ./tests/tsconfig.json --noEmit",
+		"validate-locales": "validate-locales",
+		"test:coverage": "vitest --run --coverage --config ./vitest.config.ts --no-cache",
+		"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 merge-locales && npm run validate-locales && npm run test:build && npm run test && npm run docs",
+		"dist:no-test": "npm run clean && npm run build && npm run merge-locales && npm run docs"
+	},
 	"dependencies": {
 		"@twin.org/api-auth-entity-storage-service": "next",
-		"@twin.org/cli-core": "next",
+		"@twin.org/api-tenant-processor": "next",
+		"@twin.org/context": "next",
 		"@twin.org/core": "next",
+		"@twin.org/cli-core": "next",
 		"@twin.org/crypto": "next",
 		"@twin.org/data-space-connector-models": "next",
 		"@twin.org/engine": "next",
@@ -36,20 +53,35 @@
 		"dotenv": "17.2.3",
 		"schema-dts": "1.1.5"
 	},
-	"main": "./dist/cjs/index.cjs",
-	"module": "./dist/esm/index.mjs",
+	"devDependencies": {
+		"@twin.org/entity-storage-connector-memory": "next",
+		"@twin.org/merge-locales": "next",
+		"@twin.org/nameof-transformer": "next",
+		"@twin.org/nameof-vitest-plugin": "next",
+		"@twin.org/validate-locales": "next",
+		"@twin.org/ts-to-openapi": "next",
+		"@vitest/coverage-v8": "3.2.4",
+		"copyfiles": "2.4.1",
+		"nodemon": "3.1.10",
+		"rimraf": "6.0.1",
+		"ts-patch": "3.3.0",
+		"typedoc": "0.28.13",
+		"typedoc-plugin-markdown": "4.9.0",
+		"typescript": "5.9.3",
+		"vitest": "3.2.4"
+	},
+	"main": "./dist/es/index.js",
 	"types": "./dist/types/index.d.ts",
 	"exports": {
 		".": {
 			"types": "./dist/types/index.d.ts",
-			"require": "./dist/cjs/index.cjs",
-			"import": "./dist/esm/index.mjs"
+			"import": "./dist/es/index.js",
+			"default": "./dist/es/index.js"
 		},
 		"./locales/*.json": "./locales/*.json"
 	},
 	"files": [
-		"dist/cjs",
-		"dist/esm",
+		"dist/es",
 		"dist/types",
 		"locales",
 		"docs"