@twin.org/node 0.0.3-next.65 → 0.0.3-next.67

package/dist/locales/en.json

@@ -13,7 +13,8 @@
 			"cliCommandMissing": "CLI command \"{command}\" is not recognised",
 			"cliCommandParamMissing": "Parameter \"{param}\" is required for command \"{command}\"",
 			"cliCommandParamExtra": "Parameter(s) \"{params}\" are not recognised for command \"{command}\"",
-			"cliEnvVarMissing": "Environment variable \"{envVar}\" does not exist"
+			"cliEnvVarMissing": "Environment variable \"{envVar}\" does not exist",
+			"unknownEnvVars": "Unknown environment variable properties [{keys}]. Check for typos in variable names, for custom variables use the {prefix}ENV_ALLOW_LIST."
 		},
 		"bootstrapLegacy": {
 			"noFeaturesEnabled": "No features are enabled in legacy bootstrap mode, at least one feature must be enabled.",
@@ -1366,6 +1367,40 @@
 			"responseMessage": "<=== {statusCode} {method} {requestUrl} duration: {elapsedMicroSeconds}µs"
 		}
 	},
+	"warn": {
+		"node": {
+			"unknownEnvVars": "Unknown environment variable properties [{keys}], they will be ignored. Check for typos in variable names, for custom variables use the {prefix}ENV_ALLOW_LIST."
+		},
+		"common": {
+			"devOnlyTool": "This tool is intended to be used for development purposes, it is not recommended for use in production scenarios."
+		},
+		"taskSchedulerService": {
+			"taskStalled": "Task with id \"{id}\" is stalled, last run at \"{lastRunTime}\" and exceeded timeout \"{stalledTaskTimeoutMs}\" ms"
+		},
+		"backgroundTaskService": {
+			"maxSystemWorkerCountReached": "The maximum system worker count of {maxSystemWorkerCount} has been reached, can not create any more worker for task type \"{type}\""
+		},
+		"dataspaceControlPlaneService": {
+			"catalogDatasetHasNoOffers": "Dataset has no Offers (odrl:hasPolicy) in Federated Catalogue",
+			"stalledNegotiationCleanedUp": "Stalled negotiation cleaned up (negotiationId: {negotiationId})",
+			"stalledTransferCleanedUp": "Stalled transfer cleaned up (consumerPid: {consumerPid})"
+		},
+		"dataspaceControlPlanePolicyRequester": {
+			"unknownNegotiationFinalized": "Unknown negotiation finalized (negotiationId: {negotiationId})",
+			"negotiationTerminated": "Negotiation terminated by provider (negotiationId: {negotiationId})",
+			"unknownNegotiationTerminated": "Unknown negotiation terminated (negotiationId: {negotiationId})"
+		},
+		"dataspaceDataPlaneService": {
+			"pushSubscriptionNotFoundOnTeardown": "Push subscription not found for consumerPid \"{consumerPid}\" during teardown — treating as no-op",
+			"pushSubscriptionNotFoundForActivity": "Push subscription not found for outbound activity (consumerPid: {consumerPid})"
+		},
+		"policyNegotiationAdminPointService": {
+			"sendTerminateFailed": "Failed to send terminate to consumer for negotiation id: \"{id}\", correlation id: \"{correlationId}\""
+		},
+		"policyNegotiationPointService": {
+			"terminatedCallbackFailed": "Failed to notify requester via terminated() for negotiation id: \"{negotiationId}\""
+		}
+	},
 	"node": {
 		"extensionLoading": "Loading Extension",
 		"extensionInitialisingEngine": "Initialising engine for extension \"{extension}\"",
@@ -2336,37 +2371,6 @@
 			"responseMessage": "<=== {statusCode} {method} {requestUrl} duration: {elapsedMicroSeconds}µs"
 		}
 	},
-	"warn": {
-		"common": {
-			"devOnlyTool": "This tool is intended to be used for development purposes, it is not recommended for use in production scenarios."
-		},
-		"taskSchedulerService": {
-			"taskStalled": "Task with id \"{id}\" is stalled, last run at \"{lastRunTime}\" and exceeded timeout \"{stalledTaskTimeoutMs}\" ms"
-		},
-		"backgroundTaskService": {
-			"maxSystemWorkerCountReached": "The maximum system worker count of {maxSystemWorkerCount} has been reached, can not create any more worker for task type \"{type}\""
-		},
-		"dataspaceControlPlaneService": {
-			"catalogDatasetHasNoOffers": "Dataset has no Offers (odrl:hasPolicy) in Federated Catalogue",
-			"stalledNegotiationCleanedUp": "Stalled negotiation cleaned up (negotiationId: {negotiationId})",
-			"stalledTransferCleanedUp": "Stalled transfer cleaned up (consumerPid: {consumerPid})"
-		},
-		"dataspaceControlPlanePolicyRequester": {
-			"unknownNegotiationFinalized": "Unknown negotiation finalized (negotiationId: {negotiationId})",
-			"negotiationTerminated": "Negotiation terminated by provider (negotiationId: {negotiationId})",
-			"unknownNegotiationTerminated": "Unknown negotiation terminated (negotiationId: {negotiationId})"
-		},
-		"dataspaceDataPlaneService": {
-			"pushSubscriptionNotFoundOnTeardown": "Push subscription not found for consumerPid \"{consumerPid}\" during teardown — treating as no-op",
-			"pushSubscriptionNotFoundForActivity": "Push subscription not found for outbound activity (consumerPid: {consumerPid})"
-		},
-		"policyNegotiationAdminPointService": {
-			"sendTerminateFailed": "Failed to send terminate to consumer for negotiation id: \"{id}\", correlation id: \"{correlationId}\""
-		},
-		"policyNegotiationPointService": {
-			"terminatedCallbackFailed": "Failed to notify requester via terminated() for negotiation id: \"{negotiationId}\""
-		}
-	},
 	"cli": {
 		"progress": {
 			"done": "Done.",

package/docs/changelog.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## [0.0.3-next.67](https://github.com/iotaledger/twin-node/compare/node-v0.0.3-next.66...node-v0.0.3-next.67) (2026-06-24)
+
+
+### Features
+
+* env var validation ([#243](https://github.com/iotaledger/twin-node/issues/243)) ([569945a](https://github.com/iotaledger/twin-node/commit/569945a751eb52d008a681777a3cba881af1b9a4))
+
+
+### Bug Fixes
+
+* stalled timeout now is provided in seconds ([#241](https://github.com/iotaledger/twin-node/issues/241)) ([ebd827d](https://github.com/iotaledger/twin-node/commit/ebd827d02a9a4f8ad4f4c84d064d02831ef015cb))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/node-core bumped from 0.0.3-next.66 to 0.0.3-next.67
+
+## [0.0.3-next.66](https://github.com/iotaledger/twin-node/compare/node-v0.0.3-next.65...node-v0.0.3-next.66) (2026-06-23)
+
+
+### Features
+
+* add standalone federated catalogue example config and endpoint tests ([#235](https://github.com/iotaledger/twin-node/issues/235)) ([ffb51dd](https://github.com/iotaledger/twin-node/commit/ffb51ddda5188c2f21b8ce65343b39a28f4eee4b))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/node-core bumped from 0.0.3-next.65 to 0.0.3-next.66
+
 ## [0.0.3-next.65](https://github.com/iotaledger/twin-node/compare/node-v0.0.3-next.64...node-v0.0.3-next.65) (2026-06-23)
 
 

package/docs/configuration.md

@@ -1,5 +1,16 @@
 # Node Configuration
 
+## Available Example Configurations
+
+Four ready-to-use example files are provided in `apps/node/`. Copy the relevant file to `.env` as a starting point:
+
+| File                                | Role                                                                      |
+| ----------------------------------- | ------------------------------------------------------------------------- |
+| `.env.example-local-entity-storage` | Full-featured node using local file/entity storage                        |
+| `.env.example-aws-ec2`              | Full-featured node deployed on Amazon AWS EC2 with DynamoDB               |
+| `.env.example-iota-testnet`         | Full-featured node connected to the IOTA testnet                          |
+| `.env.example-federated-catalogue`  | Standalone federated catalogue server (no dataspace or rights management) |
+
 ## Extension Loading
 
 The TWIN Node supports loading extensions dynamically to extend its functionality. Extensions can be loaded from multiple sources using protocol-based syntax.

package/docs/deployment-ec2.md

@@ -99,7 +99,7 @@ cd apps
 npm install
 npm run dist
 cd apps/node
-cp .env.example-entity-storage .env
+cp .env.example-local-entity-storage .env
 ```
 
 The .env file can be modified to suit your own use case. For example to set the location for the storage.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/node",
-	"version": "0.0.3-next.65",
+	"version": "0.0.3-next.67",
 	"description": "TWIN Node serving APIs using the specified configuration",
 	"repository": {
 		"type": "git",
@@ -14,7 +14,7 @@
 		"node": ">=20.0.0"
 	},
 	"dependencies": {
-		"@twin.org/node-core": "0.0.3-next.65"
+		"@twin.org/node-core": "0.0.3-next.67"
 	},
 	"bugs": {
 		"url": "git+https://github.com/iotaledger/twin-node/issues"