@empyria/moleculer 0.1.0 → 0.1.1

package/AGENTS.md

@@ -1,7 +1,7 @@
 # AGENTS.md
 
-Moleculer helpers for **Principia**, a nanoservice framework built primarily on Bun:
-`BaseMixin` (per-service Principia meta stamping), `MetaGuard` (a middleware guarding
+Moleculer helpers for **Empyria**, a nanoservice framework built primarily on Bun:
+`BaseMixin` (per-service Empyria meta stamping), `MetaGuard` (a middleware guarding
 actions/events against unwanted cross-federation access), and lower-level `Connector.js`/
 `util/` helpers.
 
@@ -18,7 +18,7 @@ actions/events against unwanted cross-federation access), and lower-level `Conne
 ## Known incomplete module
 
 `mixins/Connector.mixin.js` imports `@empyria/redis` and `@empyria/mongo`, which aren't
-published as standalone packages yet (they still live inside the monolithic `principia` repo's
+published as standalone packages yet (they still live inside the monolithic `empyria` repo's
 `libs/`). It is **not** re-exported from [Mixins.js](./Mixins.js) — re-adding that export line
 before those two packages exist would break every consumer's import of this whole package. Only
 re-export it once both are published; the file itself has a comment marking this.

package/MetaGuard.middleware.js

@@ -1,6 +1,6 @@
 import { validateContext, getUser } from './util/Context.js'
 
-import { PRINCIPIA_FEDERATION_ID, BaseErrors } from '@empyria/common'
+import { EMPYRIA_FEDERATION_ID, BaseErrors } from '@empyria/common'
 
 /**
  * Builds the shared guard logic for `localAction`/`remoteAction` hooks: validates the
@@ -16,10 +16,7 @@ function guardAction(next, action, resolveUser, whitelistedActions) {
 	return async (ctx) => {
 		const { user } = validateContext(ctx, action)
 
-		if (
-			whitelistedActions.includes(action.name) &&
-			user.federation !== PRINCIPIA_FEDERATION_ID
-		) {
+		if (whitelistedActions.includes(action.name) && user.federation !== EMPYRIA_FEDERATION_ID) {
 			throw new BaseErrors.ServiceVoilation({
 				service: `Microservice ${ctx.action?.name || action.name} communication`,
 			})

package/README.md

@@ -1,6 +1,6 @@
 # @empyria/moleculer
 
-Moleculer helpers for **Principia**, a nanoservice framework built primarily on Bun:
+Moleculer helpers for **Empyria**, a nanoservice framework built primarily on Bun:
 a base service mixin, and a context-validating guard middleware against unwanted
 (unauthenticated or cross-federation) access.
 
@@ -50,15 +50,15 @@ import { hashPassword, verifyPassword } from '@empyria/moleculer/util/Crypto.js'
 
 ## Modules
 
-| Module                                                   | Purpose                                                                                                                      |
-| -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
-| [Mixins.js](./Mixins.js)                                 | Package entry point; re-exports `BaseMixin` and `MetaGuard`.                                                                 |
-| [MetaGuard.middleware.js](./MetaGuard.middleware.js)     | `MetaGuard` — a Moleculer middleware guarding actions/events against unwanted access, with optional caller resolution.       |
-| [mixins/Base.mixin.js](./mixins/Base.mixin.js)           | `BaseMixin` — stamps a Principia meta (actor/federation/flow/process IDs) on service start, and exposes the package version. |
-| [mixins/Connector.mixin.js](./mixins/Connector.mixin.js) | `ConnectorMixin` — adds optional Redis/Mongo setup. **Not yet exported from `Mixins.js`** — see below.                       |
-| [Connector.js](./Connector.js)                           | `connect` — starts a Moleculer broker and waits for required services.                                                       |
-| [util/Context.js](./util/Context.js)                     | Context helpers: `getParams`, `getUser`, `validateContext`, `actionStamped`, `timeStamped`, `checkDefined`.                  |
-| [util/Crypto.js](./util/Crypto.js)                       | Hashing, Ed25519 signing/verification, and password hashing (`hashPassword`/`verifyPassword`).                               |
+| Module                                                   | Purpose                                                                                                                    |
+| -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
+| [Mixins.js](./Mixins.js)                                 | Package entry point; re-exports `BaseMixin` and `MetaGuard`.                                                               |
+| [MetaGuard.middleware.js](./MetaGuard.middleware.js)     | `MetaGuard` — a Moleculer middleware guarding actions/events against unwanted access, with optional caller resolution.     |
+| [mixins/Base.mixin.js](./mixins/Base.mixin.js)           | `BaseMixin` — stamps a Empyria meta (actor/federation/flow/process IDs) on service start, and exposes the package version. |
+| [mixins/Connector.mixin.js](./mixins/Connector.mixin.js) | `ConnectorMixin` — adds optional Redis/Mongo setup. **Not yet exported from `Mixins.js`** — see below.                     |
+| [Connector.js](./Connector.js)                           | `connect` — starts a Moleculer broker and waits for required services.                                                     |
+| [util/Context.js](./util/Context.js)                     | Context helpers: `getParams`, `getUser`, `validateContext`, `actionStamped`, `timeStamped`, `checkDefined`.                |
+| [util/Crypto.js](./util/Crypto.js)                       | Hashing, Ed25519 signing/verification, and password hashing (`hashPassword`/`verifyPassword`).                             |
 
 ### Known limitation: `ConnectorMixin`
 

package/mixins/Base.mixin.js

@@ -4,7 +4,7 @@ import { randomUUID } from 'crypto'
 
 import { fileURLToPath } from 'url'
 
-import { PRINCIPIA_FEDERATION_ID, MOLECULER_SERVICE_ROLE, moleculerMeta } from '@empyria/common'
+import { EMPYRIA_FEDERATION_ID, MOLECULER_SERVICE_ROLE, moleculerMeta } from '@empyria/common'
 
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = path.dirname(__filename)
@@ -14,8 +14,8 @@ const VERSION = JSON.parse(
 ).version
 
 /**
- * Base Moleculer mixin every Principia service builds on. On `started`, stamps a
- * Principia-flavored `meta` (actor/federation/flow/process IDs) onto the service, and
+ * Base Moleculer mixin every Empyria service builds on. On `started`, stamps a
+ * Empyria-flavored `meta` (actor/federation/flow/process IDs) onto the service, and
  * exposes the running package version as both a method and an action.
  */
 export const BaseMixin = {
@@ -30,7 +30,7 @@ export const BaseMixin = {
 
 		this.meta = moleculerMeta({
 			actor: `${this.name}-service`,
-			federation: PRINCIPIA_FEDERATION_ID,
+			federation: EMPYRIA_FEDERATION_ID,
 			flowID: randomUUID(),
 			processID: randomUUID(),
 			role: MOLECULER_SERVICE_ROLE,

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@empyria/moleculer",
-	"version": "0.1.0",
-	"description": "Moleculer helpers for Principia",
+	"version": "0.1.1",
+	"description": "Moleculer helpers for Empyria",
 	"license": "MIT",
 	"author": "Imre Fazekas <imre.fazekas@icloud.com>",
 	"repository": {
@@ -26,8 +26,8 @@
 		"test:watch": "bun test --watch"
 	},
 	"dependencies": {
-		"@empyria/classification": "0.1.0",
-		"@empyria/common": "0.1.0",
+		"@empyria/classification": "0.1.1",
+		"@empyria/common": "0.1.1",
 		"moleculer": "0.15.1"
 	},
 	"devDependencies": {

package/test/Base.mixin.test.js

@@ -1,7 +1,7 @@
 import { describe, test, expect, afterEach } from 'bun:test'
 import { ServiceBroker } from 'moleculer'
 import { BaseMixin } from '../mixins/Base.mixin.js'
-import { PRINCIPIA_FEDERATION_ID, MOLECULER_SERVICE_ROLE } from '@empyria/common'
+import { EMPYRIA_FEDERATION_ID, MOLECULER_SERVICE_ROLE } from '@empyria/common'
 
 let broker
 
@@ -10,14 +10,14 @@ afterEach(async () => {
 })
 
 describe('BaseMixin', () => {
-	test('stamps a Principia meta on start, and exposes the package version', async () => {
+	test('stamps a Empyria meta on start, and exposes the package version', async () => {
 		broker = new ServiceBroker({ logLevel: 'fatal', nodeID: 'base-mixin-test' })
 		broker.createService({ name: 'testsvc', mixins: [BaseMixin] })
 		await broker.start()
 
 		const svc = broker.getLocalService('testsvc')
 		expect(svc.meta.user.actor).toBe('testsvc-service')
-		expect(svc.meta.user.federation).toBe(PRINCIPIA_FEDERATION_ID)
+		expect(svc.meta.user.federation).toBe(EMPYRIA_FEDERATION_ID)
 		expect(svc.meta.user.role).toBe(MOLECULER_SERVICE_ROLE)
 		expect(typeof svc.meta.user.flowID).toBe('string')
 		expect(typeof svc.meta.user.processID).toBe('string')

package/test/Context.test.js

@@ -7,7 +7,7 @@ import {
 	timeStamped,
 	checkDefined,
 } from '../util/Context.js'
-import { PrincipiaError } from '@empyria/common'
+import { EmpyriaError } from '@empyria/common'
 
 describe('getParams', () => {
 	test('unwraps a body.packet envelope', () => {
@@ -62,7 +62,7 @@ describe('validateContext', () => {
 
 	test('throws when the context has no authenticated user', () => {
 		const ctx = { meta: {} }
-		expect(() => validateContext(ctx, { name: 'v1.Test.action' })).toThrow(PrincipiaError)
+		expect(() => validateContext(ctx, { name: 'v1.Test.action' })).toThrow(EmpyriaError)
 	})
 })
 
@@ -101,6 +101,6 @@ describe('checkDefined', () => {
 	})
 
 	test('throws when nothing is defined', () => {
-		expect(() => checkDefined({ a: undefined, b: null })).toThrow(PrincipiaError)
+		expect(() => checkDefined({ a: undefined, b: null })).toThrow(EmpyriaError)
 	})
 })

package/test/MetaGuard.test.js

@@ -1,6 +1,6 @@
 import { describe, test, expect } from 'bun:test'
 import { MetaGuard } from '../MetaGuard.middleware.js'
-import { PrincipiaError } from '@empyria/common'
+import { EmpyriaError } from '@empyria/common'
 
 const action = (name) => ({ name, service: { meta: {} } })
 const ctxWithUser = (federation = 'my-fed', extra = {}) => ({
@@ -22,7 +22,7 @@ describe('MetaGuard: localAction / remoteAction', () => {
 		const guard = MetaGuard({ resolveUser: false })
 		await expect(
 			guard.localAction(async () => 'ok', action('v1.Test.action'))({ meta: {} }),
-		).rejects.toThrow(PrincipiaError)
+		).rejects.toThrow(EmpyriaError)
 	})
 
 	test('rejects a cross-federation call to a whitelisted action', async () => {
@@ -37,7 +37,7 @@ describe('MetaGuard: localAction / remoteAction', () => {
 				async () => 'ok',
 				action('v1.Restricted.action'),
 			)(ctxWithUser('other-federation')),
-		).rejects.toThrow(PrincipiaError)
+		).rejects.toThrow(EmpyriaError)
 	})
 
 	test('allows a same-federation call to a whitelisted action', async () => {
@@ -103,6 +103,6 @@ describe('MetaGuard: localEvent', () => {
 		const guard = MetaGuard({ resolveUser: false })
 		await expect(
 			guard.localEvent(async () => 'ok', action('some.event'))({ meta: {} }),
-		).rejects.toThrow(PrincipiaError)
+		).rejects.toThrow(EmpyriaError)
 	})
 })

package/util/Context.js

@@ -34,7 +34,7 @@ export function getUser(ctx, action) {
  * @param {Object} [action] - The action/event being guarded.
  * @returns {{user: Object, tokenKey: string}|undefined} The context's user/tokenKey, or
  *   `undefined` for a `$`-prefixed internal action.
- * @throws {PrincipiaError} `BaseErrors.ServiceVoilation` if `ctx.meta.user` is missing or incomplete.
+ * @throws {EmpyriaError} `BaseErrors.ServiceVoilation` if `ctx.meta.user` is missing or incomplete.
  */
 export function validateContext(ctx, action) {
 	const { user, tokenKey } = ctx.meta
@@ -82,7 +82,7 @@ export function timeStamped(object) {
  * at least one to be present.
  * @param {Object} object - Object to filter.
  * @returns {Object} The defined-only copy.
- * @throws {PrincipiaError} `BaseErrors.MissingData` if no properties are defined.
+ * @throws {EmpyriaError} `BaseErrors.MissingData` if no properties are defined.
  */
 export function checkDefined(object) {
 	const res = cloneDefined(object)